capDlgVideoFormat

The capDlgVideoFormat macro displays a dialog box in which the user can select the video format. The Video Format dialog box might be used to select image dimensions, bit depth, and hardware compression options. You can use this macro or explicitly send the WM_CAP_DLG_VIDEOFORMAT message.

BOOL capDlgVideoFormat(
  hwnd  
);
 

Parameters

hwnd
Handle of a capture window.

Return Values

Returns TRUE if successful or FALSE otherwise.

Remarks

After this message returns, applications might need to update the CAPSTATUS structure because the user might have changed the image dimensions.

The Video Format dialog box is unique for each capture driver. Some capture drivers might not support a Video Format dialog box. Applications can determine if the capture driver supports this message by checking the fHasDlgVideoFormat member of CAPDRIVERCAPS.

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, CAPDRIVERCAPS, CAPSTATUS, WM_CAP_DLG_VIDEOFORMAT