DRV_CONFIGURE message
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:
| Requirement | Value |
|---|---|
| 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
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows 2000 Professional [desktop apps only] |
| Minimum supported server |
Windows 2000 Server [desktop apps only] |
| Header |
|