DRV_CONFIGURE
Directs the installable driver to display its configuration dialog box and let the user specify new settings for the given installable driver instance.
Parameters
dwDriverId
Identifier of the installable driver. This is the same value previously returned by the driver from the DRV_OPEN message.
hdrvr
Handle of the installable driver instance.
lParam1
Handle of the parent window. This window is used as the parent window for the configuration dialog box.
lParam2
Address of a DRVCONFIGINFO structure or NULL. If the structure is given, it contains the names of the registry key and value associated with the driver.
Return Value
Returns one of these values:
| DRVCNF_OK | The configuration is successful; no further action is required. |
| DRVCNF_CANCEL | The user canceled the dialog box; no further action is required. |
| DRVCNF_RESTART | The configuration is successful, but the changes do not take effect until the system is restarted. |
Remarks
Some installable drivers append configuration information to the value assigned to the registry value associated with the driver.
The DRV_CANCEL, DRV_OK, and DRV_RESTART return values are obsolete; they have been replaced by DRVCNF_CANCEL, DRVCNF_OK, and DRVCNF_RESTART, respectively.
Requirements
** Windows NT/2000:** Requires Windows NT 3.1 or later.
** Windows 95/98:** Requires Windows 95 or later.
** Header:** Declared in Mmsystem.h.
See Also