Share via


capGrabFrame

The capGrabFrame macro retrieves and displays a single frame from the capture driver. After capture, overlay and preview are disabled. You can use this macro or explicitly call the WM_CAP_GRAB_FRAME message.

BOOL capGrabFrame(
  hwnd  
);

Parameters

hwnd

Handle to a capture window.

Return Values

Returns TRUE if successful or FALSE otherwise.

Remarks

For information about installing callback functions, see the capSetCallbackOnError and capSetCallbackOnFrame macros.

Requirements

**  Windows NT/2000/XP:** Included in Windows NT 3.1 and later.
**  Windows 95/98/Me:** Included in Windows 95 and later.
**  Header:** Declared in Vfw.h.

See Also

Video Capture, Video Capture Macros, capSetCallbackOnError, capSetCallbackOnFrame, WM_CAP_GRAB_FRAME