capSetVideoFormat

The capSetVideoFormat macro sets the format of captured video data. You can use this macro or explicitly call the WM_CAP_SET_VIDEOFORMAT message.

BOOL capSetVideoFormat(
  hwnd,           
  psVideoFormat,  
  wSize           
);
 

Parameters

hwnd
Handle of a capture window.
psVideoFormat
Address of a BITMAPINFO structure.
wSize
Size, in bytes, of the structure referenced by s.

Return Values

Returns TRUE if successful or FALSE otherwise.

Remarks

Because video formats are device-specific, applications should check the return value from this function to determine if the format is accepted by the driver.

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, BITMAPINFO, WM_CAP_SET_VIDEOFORMAT