ILMVAdd Interface

Data types:

ADDATTRIBUTES:

typedef struct _ADDATTRIBUTES 
{ 
   BOOL bEnable; 
   BOOL bPreserveFrameRate; 
   BOOL bAverage; 
   INT nFrames; 
   INT nFactors[MAX_BUFFERS]; 
   INT nCurFrame; /* internal use */ 
} ADDATTRIBUTES;

Describes addition attributes.

Member	Description
bEnable	TRUE to enable the effect.
bReserveFrameRate	TRUE to use previous frames to enhance frame rate, the output is not exactly the same as when setting this member to FALSE.
bAverage	TRUE to enable frame averaging
nFrames	Number of frames to add.
nFactors	Array of nFrames that contains the usage factors of each frame (i.e. nFactors[0] = 80% then 80 percent of the values in the first frame is used in the addition process).

Interface methods:

HRESULT IsLEADInputPinConnected()

Parameters

None.

Description

Determines whether the filter input pin is currently connected.

Returns

S_OK if connected, S_FALSE otherwise.

HRESULT IsLEADOutputPinConnected()

Parameters

None.

Description

Determines whether the filter output pin is currently connected.

Returns

S_OK if connected, S_FALSE otherwise.

HRESULT SetAddAttributes(ADDATTRIBUTES AddAttributes )

Parameters

AddAttributes

An ADDATTRIBUTES structure that contains properties to set.

Description

Sets the properties for the add effect. Attributes are set permanently and they cant be canceled. If the filter is streaming, the effect will take place immediately.

Returns

S_OK if successful, S_FALSE otherwise.

HRESULT GetAddAttributes(ADDATTRIBUTES * pAddAttributes )

Parameters

pAddAttributes

A valid pointer to an ADDATTRIBUTES structure to be updated with the current settings.

Description

Retrieves the current addition attributes.

Returns

S_OK if successful, S_FALSE otherwise.

HRESULT GetIODimensions(long plInWidth, long plInHeight, long plOutWidth, long plOutHeight)

Parameters

plInWidth	A valid pointer to a long variable to be updated with the input media width. NULL can be passed if this value is not needed.
plInHeight	A valid pointer to a long variable to be updated with the input media height. NULL can be passed if this value is not needed.
plOutWidth	A valid pointer to a long variable to be updated with the output media width. NULL can be passed if this value is not needed.
plOutHeight	A valid pointer to a long variable to be updated with the output media height. NULL can be passed if this value is not needed.

Description

Retrieves the current media dimensions.

Returns

S_OK if successful, S_FALSE otherwise.

HRESULT GetIOBitCount(int pInBitCount, int pOutBitCount)

Parameters

pInBitCount	A valid pointer to an integer to be updated with the input media bits per pixel value. NULL can be passed if this value is not needed.
pOutBitCount	A valid pointer to an integer to be updated with the output media bits per pixel value. NULL can be passed if this value is not needed.