Redigera

Dela via

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

BOOL 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

Type: BOOL

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.

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