DefDriverProc

LRESULT WINAPI
DefDriverProc (
DWORD
dwDriverID,
HDRVR
hDriver,
UINT
uMsg,
LPARAM
lParam1,
LPARAM
lParam2
);

The DefDriverProc function is called by user-mode multimedia drivers to handle messages not processed by the driver's DriverProc function. The function is defined in winmm.dll.

Parameters

dwDriverID

Value passed to the driver as the dwDriverID argument to DriverProc.

hDriver

Value passed to the driver as the hDriver argument to DriverProc.

uMsg

Value passed to the driver as the uMsg argument to DriverProc.

lParam1

Value passed to the driver as the lParam1 argument to DriverProc.

lParam2

Value passed to the driver as the lParam2 argument to DriverProc.

Return Value

The DefDriverProc function returns a value that is based on the received message. Return values are shown in the following table.

Message Return Value
DRV_LOAD 1
DRV_FREE 1
DRV_ENABLE 1
DRV_DISABLE 1
DRV_INSTALL DRV_OK
DRV_REMOVE DRV_OK
All other messages. 0

Comments

A user-mode driver calls DefDriverProc by passing it the same arguments the driver received as input to its DriverProc function.

Typically, a user-mode driver's DriverProc function assigns supported uMsg values to C-language case statement arguments, and associates DefDriverProc with a default statement. Refer to the sample drivers for examples. The value returned from DefDriverProc should be used as the return value for DriverProc.