capSetCallbackOnStatus

  • Article

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 to a capture window.

fpProc

Pointer to the status callback function, of type capStatusCallback. 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.

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

Creating a Status Callback Function, Video Capture, Video Capture Macros, capStatusCallback, WM_CAP_SET_CALLBACK_STATUS