capSetCallbackOnFrame macro (vfw.h)

The capSetCallbackOnFrame macro sets a preview callback function in the application. AVICap calls this procedure when the capture window captures preview frames. You can use this macro or explicitly call the WM_CAP_SET_CALLBACK_FRAME message.

Syntax

void capSetCallbackOnFrame(
   hwnd,
   fpProc
);

Parameters

hwnd

Handle to a capture window.

fpProc

Pointer to the preview callback function, of type capVideoStreamCallback. Specify NULL for this parameter to disable a previously installed callback function.

Return value

None

Remarks

The capture window calls the callback function before displaying preview frames. This allows an application to modify the frame if desired. This callback function is not used during streaming video capture.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header vfw.h

See also

Creating a Frame Callback Function

Video Capture

Video Capture Macros