Edit

capSetCallbackOnError macro (vfw.h)

  • Article

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

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header vfw.h

See also

Creating an Error Callback Function

Video Capture

Video Capture Macros

WM_CAP_SET_CALLBACK_ERROR

capErrorCallback