ICM_CONFIGURE

The ICM_CONFIGURE message notifies a video compression driver to display its configuration dialog box or queries a video compression driver to determine if it has a configuration dialog box. You can send this message explicitly or by using the ICConfigure macro.

ICM_CONFIGURE 
wParam = (DWORD) (UINT) hwnd; 
lParam = 0; 
 

Parameters

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 message or ICERR_UNSUPPORTED otherwise.

Remarks

This 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 ICM_GETSTATE and ICM_SETSTATE messages. 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 Messages, DRV_CONFIGURE, ICConfigure, ICM_GETSTATE, ICM_SETSTATE, ICQueryConfigure