capSetCallbackOnError

The capSetCallbackOnError macro sets an error callback function in the client application. AVICap calls this procedure when errors occur. You can use this macro or explicitly call the WM_CAP_SET_CALLBACK_ERROR message.

BOOL capSetCallbackOnError(
  hwnd,  
  fpProc 
);
 

Parameters

hwnd

Handle of a capture window.

fpProc

Address of the error callback function. Specify NULL for this parameter to disable a previously installed error 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 an error callback function. If set, AVICap calls the error procedure in the following situations:

• The disk is full.
• A capture window cannot be connected with a capture driver.
• A waveform-audio device cannot be opened.
• The number of frames dropped during capture exceeds the specified percentage.
• The frames cannot be captured due to vertical synchronization interrupt problems.

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_ERROR