CAPSTATUSCALLBACKW callback function (vfw.h)

The capStatusCallback function is the status callback function used with video capture. The name capStatusCallback is a placeholder for the application-supplied function name.

To set the callback, send the WM_CAP_SET_CALLBACK_STATUS message to the capture window or call the capSetCallbackOnStatus macro.

Syntax

CAPSTATUSCALLBACKW Capstatuscallbackw;

LRESULT Capstatuscallbackw(
  HWND hWnd,
  int nID,
  LPCWSTR lpsz
)
{...}

Parameters

hWnd

Handle to the capture window associated with the callback function.

nID

Message identification number.

lpsz

Pointer to a textual description of the returned status.

Return value

None

Remarks

During capture operations, the first message sent to the callback function is always IDS_CAP_BEGIN and the last is always IDS_CAP_END. A message identifier of zero indicates a new operation is starting and the callback function should clear the current status.

Note

The vfw.h header defines CAPSTATUSCALLBACK as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

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

Video Capture

Video Capture Functions