capSetCallbackOnError macro (vfw.h)

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.

Syntax

void capSetCallbackOnError(
   hwnd,
   fpProc
);

Parameters

hwnd

Handle to a capture window.

fpProc

Pointer to the error callback function, of type capErrorCallback. Specify NULL for this parameter to disable a previously installed error callback function.

Return value

None

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.

Requirements

See also

Creating an Error Callback Function

Video Capture

Video Capture Macros

WM_CAP_SET_CALLBACK_ERROR

capErrorCallback