DRV_REMOVE

The DRV_REMOVE message requests a user-mode multimedia driver to allow a system administrator to perform removal 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_REMOVE

lParam1

Not used. Set to zero.

lParam2

Not used. Set to zero.

Return Value

Drivers provide one of the following return values:

DRVCNF_CANCEL	The removal operation failed.
DRVCNF_OK	The removal operation was successful.
DRVCNF_RESTART	The removal operation was successful. The removal does not take effect until Windows NT is restarted.

Comments

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

Removal is the opposite of installation. Removal operations might include removing a kernel-mode driver and deleting Windows NT Registry keys that were created during installation.

Drivers receive a DRV_OPEN message before receiving DRV_REMOVE.

If the driver returns DRVCNF_RESTART, you can assume that the caller will display a message telling the administrator to restart Windows NT.

See Also

DRV_INSTALL