capSetCallbackOnError  A1VEFT 

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_ERROR1EFK0BS 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.

 

See Also

WM_CAP_SET_CALLBACK_ERROR