capSetCallbackOnVideoStream

The capSetCallbackOnVideoStream macro sets a callback function in the application. AVICap calls this procedure during streaming capture when a video buffer is filled. You can use this macro or explicitly call the WM_CAP_SET_CALLBACK_VIDEOSTREAM message.

BOOL capSetCallbackOnVideoStream(
  hwnd,  
  fpProc 
);

Parameters

hwnd

Handle to a capture window.

fpProc

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

Return Values

Returns TRUE if successful or FALSE if streaming capture or a single-frame capture session is in progress.

Remarks

The capture window calls the callback function before writing the captured frame to disk. This allows applications to modify the frame if desired.

If a video stream callback function is used for streaming capture, the procedure must be installed before starting the capture session and it must remain enabled for the duration of the session. It can be disabled after streaming capture ends.

Requirements

**  Windows NT/2000/XP:** Included in Windows NT 3.1 and later.
**  Windows 95/98/Me:** Included in Windows 95 and later.
**  Header:** Declared in Vfw.h.

See Also

Video Capture, Video Capture Macros, capVideoStreamCallback, WM_CAP_SET_CALLBACK_VIDEOSTREAM