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.