capSetCallbackOnStatus

The capSetCallbackOnStatus macro sets a status callback function in the application. AVICap calls this procedure whenever the capture window status changes. You can use this macro or explicitly call the WM_CAP_SET_CALLBACK_STATUS message.

BOOL capSetCallbackOnStatus(
  hwnd,  
  fpProc 
);
 

Parameters

hwnd

Handle of a capture window.

fpProc

Address of the status callback function. Specify NULL for this parameter to disable a previously installed status callback function.

Return Values

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

Remarks

Applications can optionally set a status callback function. If set, AVICap calls this procedure in the following situations:

• A capture session is completed.
• A capture driver successfully connected to a capture window.
• An optimal palette is created.
• The number of captured frames is reported.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in vfw.h.

See Also

Video Capture Overview, Video Capture Macros, WM_CAP_SET_CALLBACK_STATUS