Products | Support | Send comments on this topic. | Email a link to this topic. | Back to Getting Started | Help Version 18.0.10.24
LEADTOOLS Filters Help

ILMVUserCallback Interface

Show in webframe

The ILMVUserCallback 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.

Interface Methods:

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

Parameters

pData

A valid pointer to the frame data, passed in a long 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).

Description

This method is called for each frame received by the Video Callback Filter. The user can modify each frame by making changes to the frame's data.

Return

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

Value

Meaning

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.

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

Note for .NET users: For more examples on how to use the frame data in .NET applications, look at the sample code from ILMAUserCallback2 Interface.

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 an HRESULT exception before returning from ReceiveProc. One way to do this is as shown in the following example:

public class ReturnValueException : Exception
{
   public ReturnValueException(object HResultValue)
   {
      HResult = (int)HResultValue;
   }
}

public class LEADCallbackPlay : LMVCallbackLib.ILMVUserCallback
{
   public void ReceiveProc(int 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(LMVCallbackLib.VdCalBkErrConstants.VDCALBK_ERR_DROP);
   }
}

Products | Support | Contact Us | Copyright Notices
© 2006-2014 All Rights Reserved. LEAD Technologies, Inc.