DRV_INSTALL message

Notifies the driver that is it being installed. The driver should create and initialize any needed registry keys and values and verify that the supporting drivers and hardware are installed and properly configured.

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.

lParam2

Address of a DRVCONFIGINFO structure or NULL. If a 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 installation is successful; no further action is required.
DRVCNF_CANCEL The installation failed..
DRVCNF_RESTART The installation is successful, but it does not take effect until the system is restarted.

Remarks

The lParam1 parameter is not used.

Some installable drivers append configuration information to the value assigned to the registry value associated with the driver.

Requirements

Requirement Value
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