The DRV_INSTALL message requests a user-mode multimedia driver to allow a system administrator to perform installation operations.
Parameters
dwDriverID
Driver instance identifier. This is the value returned by the driver in response to the DRV_OPEN message.
hDriver
Driver handle.
uMsg
DRV_INSTALL
lParam1
Specifies the handle to the parent window the driver should use when creating a configuration dialog box.
lParam2
If not null, specifies the address of a DRVCONFIGINFO structure.
Return Value
Drivers provide one of the following return values:
| DRVCNF_CANCEL | The installation operation should be canceled. |
| DRVCNF_OK | The installation operation was successful. |
| DRVCNF_RESTART | The installation operation was successful. The installation does not take effect until Windows NT is restarted. |
Comments
The DRV_INSTALL message is one of the standard driver messages. A client sends the message by calling the driver's DriverProc entry point, passing the specified parameter values. Typically, this message is sent by the Control Panel's Multimedia applet.
Drivers receive DRV_LOAD, DRV_ENABLE, and DRV_OPEN messages before receiving DRV_INSTALL.
Installation operations include installing a kernel-mode driver, and creating Windows NT Registry keys along with their default values. Windows NT only allows users with Administrator privilege to install kernel-mode drivers, as discussed in Installing a Kernel-Mode Multimedia Driver.
Some drivers combine installation and configuration operations into one step and perform them upon receipt of either a DRV_INSTALL or a DRV_CONFIGURE message.
If the driver returns DRVCNF_RESTART, you can assume that the caller will display a message telling the administrator to restart Windows NT.
For more information about driver installation, see Installing Multimedia Drivers.