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 of 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.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in vfw.h.

See Also

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