capGetStatus macro (vfw.h)

The capGetStatus macro retrieves the status of the capture window. You can use this macro or explicitly call the WM_CAP_GET_STATUS message.

Syntax

void capGetStatus(
   hwnd,
   s,
   wSize
);

Parameters

hwnd

Handle to a capture window.

s

Pointer to a CAPSTATUS structure.

wSize

Size, in bytes, of the structure referenced by s.

Return value

None

Remarks

The CAPSTATUS structure contains the current state of the capture window. Since this state is dynamic and changes in response to various messages, the application should initialize this structure after sending the capDlgVideoFormat macro and whenever it needs to enable menu items or determine the actual state of the window.

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 Macros