ICM_CONFIGURE

The ICM_CONFIGURE message is sent to a video compression driver to display its configuration dialog box.

Parameters

dwParam1

Specifies a handle to a window (HWND) that should correspond to parent of the displayed dialog box.

If dwParam1 is -1, a driver returns ICERR_OK if it has a configuration dialog box but it should not display the dialog box. The driver returns ICERR_UNSUPPORTED if it does not display a dialog box.

dwParam2

Not used.

Return Value

Returns ICERR_OK if the driver supports this message. Otherwise, returns ICERR_UNSUPPORTED.

Comments

This message is distinct from the DRV_CONFIGURE message used for hardware configuration. The dialog box for this message should let the user configure the internal state referenced by ICM_GETSTATE and ICM_SETSTATE. For example, this dialog box might let the user change parameters affecting the quality level and other similar compression options.