de.humatic.dsj.com

Class IAMStreamConfig

java.lang.Object

de.humatic.dsj.com.COMObject

de.humatic.dsj.com.IAMStreamConfig

public class IAMStreamConfig
extends COMObject

Wrapper around the native IAMStreamConfig interface exposed by some capture devices' and VfW encoders' output pins. If exposed this allows for setting desired output formats before connecting a filter's output. The filter's input will usually need to be connected before setting an output format.
To get an instance of this class, call COMFactory.queryInterface(...) with the pin of interest and COMFactory.IID_IAMStreamConfig as arguments.
For more information see MSDN documentation.

Method Summary

Modifier and Type	Method and Description
DSMediaType	getFormat(int index) Returns the nth available output type.
int	getNumberOfCapabilities() Returns the number of available output mediatype / streamconfig combinations
int[]	getStreamCaps(int index) Returns an int[] containing min / max and stepsize values along which an available output mediatype (as returned by getFormat(index)) may be finetuned before setting it as the pin's output type.
void	setFormat(DSMediaType newFormat) Sets an eventually finetuned mediatype as the new output format for the pin to use on the next output connection.

Methods inherited from class de.humatic.dsj.com.COMObject

getCLSID, getServer, release

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getNumberOfCapabilities

public int getNumberOfCapabilities()

Returns the number of available output mediatype / streamconfig combinations

getFormat

public DSMediaType getFormat(int index)
                      throws DSJException

Returns the nth available output type. This can eventually be modified along parameters and ranges given in the corresponding STREAM_CONFIG_CAP structure (as returned by getStreamCaps(index)) and then be set as the new output type. Note that only some filters / pins will allow for mediatype modification (values in the STREAM_CONFIG_CAP may all be zero) and the filters input will generally need to be connected before setting a desired output format.

Throws:

DSJException

getStreamCaps

public int[] getStreamCaps(int index)
                    throws DSJException

Returns an int[] containing min / max and stepsize values along which an available output mediatype (as returned by getFormat(index)) may be finetuned before setting it as the pin's output type. Note that only some filters / pins will allow for mediatype modification (values in the STREAM_CONFIG_CAP may all be zero) and the filters input will generally need to be connected before setting a desired output format.
For more information on the contents of the returned array see VIDEO_STREAM_CONFIG_CAPS and AUDIO_STREAM_CONFIG_CAPS documentation on msdn. Note: The native structs are deprecated and MS recommends not to use them.

Throws:

DSJException

setFormat

public void setFormat(DSMediaType newFormat)

Sets an eventually finetuned mediatype as the new output format for the pin to use on the next output connection. This method will fail if the filter's input is not connected.
Some filters accept null as a parameter to reset to defaults.