ILMVUserCallback2 Interface

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

Data Types

VdCalBkErrConstants

Summary

Lists the possible error code values that can be returned by the ReceiveProc method.

Syntax

typedef enum VdCalBkErrConstants 
{ 
   VDCALBK_ERR_OK,				/* Success. The filter continues normally, delivering the processed frame. */ 
   VDCALBK_ERR_DROP,			/* Do not deliver the frame. The filter drops the frame and continues normally with the next frame in the stream. */ 
   VDCALBK_ERR_DELIVERLASTFRAME,/* Deliver the previous frame (the last one delivered). The filter saves the last frame it delivers downstream, in case the same frame is needed more than once. */ 
} VdCalBkErrConstants; 

Methods

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

Description

This method is called for each frame received by the Video Callback Transform. 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.

Parameters

Returns

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

Note for C/C++ users: Simply cast pData to a pointer to unsigned char.

Note for .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 app, you need to throw a 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 : LMFVCallbackLib.ILMVUserCallback2 
{ 
   public void ReceiveProc(long pData, int lWidth, int lHeight, int lBitCount, int lSize, int bTopDown) 
   { 
      ' you need to throw an error only if you want to return anything other that VDCALBK_ERR_OK 
      ' throw new ReturnValueException(LMFVCallbackLib.VdCalBkErrConstants.VDCALBK_ERR_DROP); 
   } 
}