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 can’t 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.

Description

Gets the bits per pixel of the current connected input and output media formats.

Return

S_OK if successful, S_FALSE otherwise.