Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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:

DRVCNF_OKThe configuration is successful; no further action is required.
DRVCNF_CANCELThe user canceled the dialog box; no further action is required.
DRVCNF_RESTARTThe 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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Mmsystem.h (include Windows.h)

See also

Installable Drivers
Installable Driver Messages

 

 

Community Additions

Show:
© 2014 Microsoft