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.