ILMVUserCallback3 Interface

The ILMVUserCallback3 interface is a user-defined interface. It must be registered by calling the put_ReceiveProcObj method of the ILMVCallback interface. This interface has one method.

Methods

HRESULT ReceiveProc (LONGLONG pData, long lWidth, long lHeight, long lBitCount, long lSize, long bTopDown, long lFOURCC)

Description

This method is called for each frame received by the Video Callback Filter.

Parameters

pData

A valid pointer to the frame data, passed in a LONGLONG (__int64) variable.

lWidth

Width of the frame.

lHeight

Height of the frame.

lBitCount

Bits per pixel of the frame.

lSize

Size of the frame buffer, in bytes.

bTopDown

Value that indicates whether the image in the passed buffer (pData) is top-down (1) or bottom-up (0).

lFOURCC

A FOURCC code value representing the media format for the frame. 0 indicates an RGB format.

Comments

The user can modify each frame by making changes to the frame's data. Please note that the memory for each frame is owned by the callback filter. If you wish to keep the frame data, you must make a copy of it. The user callback can dictate if this frame should continue to be used after the callback via the user callback function return code.

Notes

• C/C++ users: you can simply cast pData to a pointer to unsigned char.

• .NET users:

  • For more examples on how to use the frame data in .NET applications, look at the sample code from ILMAUserCallback3 Interface.

  • .NET users: These callbacks are implemented in .NET as a function without a return value. In order to be able to return a value other than VDCALBK_ERR_OK from your application, you need to throw an HRESULT exception before returning from ReceiveProc. One way do this is as in the following example:

    public class ReturnValueException : Exception 
    { 
       public ReturnValueException(object HResultValue) 
       { 
          HResult = (int)HResultValue; 
       } 
    } 
    public class LEADCallbackPlay : LMVCallbackLib.ILMVUserCallback3 
    { 
       public void ReceiveProc(int pData, int lWidth, int lHeight, int lBitCount, int lSize, int bTopDown, int lFOURCC) 
       { 
          ' you need to throw an error only if you want to return anything other that VDCALBK_ERR_OK 
          ' throw new ReturnValueException(LMVCallbackLib.VdCalBkErrConstants.VDCALBK_ERR_DROP); 
       } 
    } 

Returns

After working on the frame data, this method can return one of the following values: