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.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in mmsystem.h.