Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Processes driver messages for the installable driver. DriverProc is a driver-supplied function.
Syntax
DRIVERPROC Driverproc;
LRESULT Driverproc(
DWORD_PTR unnamedParam1,
HDRVR unnamedParam2,
UINT unnamedParam3,
LPARAM unnamedParam4,
LPARAM unnamedParam5
)
{...}
Parameters
unnamedParam1
Identifier of the installable driver.
unnamedParam2
Handle of the installable driver instance. Each instance of the installable driver has a unique handle.
unnamedParam3
Driver message value. It can be a custom value or one of these standard values:
| Value | Meaning |
|---|---|
| Notifies the driver that it should decrement its usage count and unload the driver if the count is zero. | |
| Notifies the driver that it should display a configuration dialog box. This message is sent only if the driver returns a nonzero value when processing the DRV_QUERYCONFIGURE message. | |
| Notifies the driver that its allocated memory is about to be freed. | |
| Notifies the driver that it has been loaded or reloaded or that Windows has been enabled. | |
| Notifies the driver that it will be discarded. | |
| Notifies the driver that it has been successfully installed. | |
| Notifies the driver that it has been successfully loaded. | |
| Notifies the driver that it is about to be opened. | |
| Notifies the driver that the device's power source is about to be turned on or off. | |
| Directs the driver to specify whether it supports the DRV_CONFIGURE message. | |
| Notifies the driver that it is about to be removed from the system. |
unnamedParam4
32-bit message-specific value.
unnamedParam5
32-bit message-specific value.
Return value
Returns nonzero if successful or zero otherwise.
Remarks
When msg is DRV_OPEN, lParam1 is the string following the driver filename from the SYSTEM.INI file and lParam2 is the value given as the lParam parameter in a call to the OpenDriver function.
When msg is DRV_CLOSE, lParam1 and lParam2 are the same values as the lParam1 and lParam2 parameters in a call to the CloseDriver function.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | mmiscapi.h (include Mmiscapi.h, Windows.h) |