ICConfigure

The ICConfigure macro notifies a video compression driver to display its configuration dialog box. You can use this macro or explicitly send the ICM_CONFIGURE message.

DWORD ICConfigure(
  hic,  
  hwnd  
);
 

Parameters

hic

Handle of the compressor.

hwnd

Handle of the parent window of the displayed dialog box.

You can determine if a driver has a configuration dialog box by specifying – 1 in this parameter, as in the ICQueryConfigure macro.

Return Values

Returns ICERR_OK if the driver supports this macro or ICERR_UNSUPPORTED otherwise.

Remarks

The ICM_CONFIGURE message is different from the DRV_CONFIGURE message used for hardware configuration. The dialog box for this message should let the user set and edit the internal state referenced by the ICGetState and ICSetState macros. For example, this dialog box can let the user change parameters affecting the quality level and other similar compression options.

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 Compression Manager Overview, Video Compression Macros, DRV_CONFIGURE ICM_CONFIGURE, ICGetState, ICQueryConfigure, ICSetState