ICM_CONFIGURE

  • Article

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

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 Compression Manager, Video Compression Messages, DRV_CONFIGURE, ICConfigure, ICM_GETSTATE, ICM_SETSTATE, ICQueryConfigure