Partager via


DRV_INSTALL

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:

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

**  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

Installable Drivers, Installable Driver Messages