Share via

capDlgVideoFormat

  • Article

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

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