DRV_INSTALL

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.