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.
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. |
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.