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.