nc-mmiscapi-driverproc.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NC:mmiscapi.DRIVERPROC	DRIVERPROC (mmiscapi.h)	Processes driver messages for the installable driver. DriverProc is a driver-supplied function.	DRIVERPROC DRIVERPROC callback function [Windows Multimedia] DRV_CLOSE DRV_CONFIGURE DRV_DISABLE DRV_ENABLE DRV_FREE DRV_INSTALL DRV_LOAD DRV_OPEN DRV_POWER DRV_QUERYCONFIGURE DRV_REMOVE DriverProc callback _win32_DriverProc mmsystem/DRIVERPROC multimedia.driverproc	multimedia\driverproc.htm	Multimedia	d9a5535f-6b80-40cc-a20b-b7a342414d7f	12/05/2018	DRIVERPROC, DRIVERPROC callback function [Windows Multimedia], DRV_CLOSE, DRV_CONFIGURE, DRV_DISABLE, DRV_ENABLE, DRV_FREE, DRV_INSTALL, DRV_LOAD, DRV_OPEN, DRV_POWER, DRV_QUERYCONFIGURE, DRV_REMOVE, DriverProc callback, _win32_DriverProc, mmsystem/DRIVERPROC, multimedia.driverproc	mmiscapi.h	Mmiscapi.h, Windows.h	Windows	Windows 2000 Professional [desktop apps only]	Windows 2000 Server [desktop apps only]													Windows			19H1	DRIVERPROC mmiscapi/DRIVERPROC	c++	APIRef kbSyntax	UserDefined	Mmsystem.h	DRIVERPROC

DRIVERPROC callback function

-description

Processes driver messages for the installable driver. DriverProc is a driver-supplied function.

-parameters

-param unnamedParam1

Identifier of the installable driver.

-param unnamedParam2

Handle of the installable driver instance. Each instance of the installable driver has a unique handle.

-param unnamedParam3

Driver message value. It can be a custom value or one of these standard values:

Value	Meaning
DRV_CLOSE	Notifies the driver that it should decrement its usage count and unload the driver if the count is zero.
DRV_CONFIGURE	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.
DRV_DISABLE	Notifies the driver that its allocated memory is about to be freed.
DRV_ENABLE	Notifies the driver that it has been loaded or reloaded or that Windows has been enabled.
DRV_FREE	Notifies the driver that it will be discarded.
DRV_INSTALL	Notifies the driver that it has been successfully installed.
DRV_LOAD	Notifies the driver that it has been successfully loaded.
DRV_OPEN	Notifies the driver that it is about to be opened.
DRV_POWER	Notifies the driver that the device's power source is about to be turned on or off.
DRV_QUERYCONFIGURE	Directs the driver to specify whether it supports the DRV_CONFIGURE message.
DRV_REMOVE	Notifies the driver that it is about to be removed from the system.

-param unnamedParam4

32-bit message-specific value.

-param unnamedParam5

32-bit message-specific value.

-returns

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.

-see-also

Driver Functions

Installable Drivers