DRV_PNPINSTALL

The DRV_PNPINSTALL message requests a user-mode multimedia driver to allow a system administrator to perform installation operations, using Plug and Play configuration information.

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_PNPINSTALL

lParam1

Handle to a device information set. The handle type is HDEVINFO, which is defined in setupapi.h.

lParam2

Pointer to an SP_DEVINFO_DATA 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_PNPINSTALL 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 Media Class Installer, which is included in the Control Panel’s Multimedia applet.

If the system provides Plug and Play capabilities, the driver receives this message instead of DRV_INSTALL. The driver uses the received lParam1 and lParam2 values as inputs to the SetupDi-prefixed device installation functions provided by setupapi.dll. For descriptions of the device installation functions, see the Programmer’s Guide.

For more information about responding to the DRV_PNPINSTALL and DRV_CONFIGURE messages on a Windows NT system providing Plug and Play capabilities, see the user-mode driver source code for the Creative Labs Sound Blaster, which is one of the sample audio drivers.