Функция обратного вызова DRIVERPROC (mmiscapi.h)

Обрабатывает сообщения драйвера для устанавливаемого драйвера. DriverProc — это функция, предоставляемая драйвером.

Синтаксис

DRIVERPROC Driverproc;

LRESULT Driverproc(
  DWORD_PTR unnamedParam1,
  HDRVR unnamedParam2,
  UINT unnamedParam3,
  LPARAM unnamedParam4,
  LPARAM unnamedParam5
)
{...}

Параметры

unnamedParam1

Идентификатор устанавливаемого драйвера.

unnamedParam2

Дескриптор устанавливаемого экземпляра драйвера. Каждый экземпляр устанавливаемого драйвера имеет уникальный дескриптор.

unnamedParam3

Значение сообщения драйвера. Это может быть пользовательское значение или одно из следующих стандартных значений:

Значение Значение
DRV_CLOSE
Уведомляет драйвер о необходимости уменьшения его количества использования и выгружает драйвер, если счетчик равен нулю.
DRV_CONFIGURE
Уведомляет драйвер о том, что он должен отобразить диалоговое окно конфигурации. Это сообщение отправляется только в том случае, если драйвер возвращает ненулевое значение при обработке сообщения DRV_QUERYCONFIGURE .
DRV_DISABLE
Уведомляет драйвер о том, что выделенная память будет освобождена.
DRV_ENABLE
Уведомляет драйвер о том, что он был загружен или перезагружен или что windows включена.
DRV_FREE
Уведомляет драйвер о том, что он будет удален.
DRV_INSTALL
Уведомляет драйвер об успешной установке.
DRV_LOAD
Уведомляет драйвер о том, что он успешно загружен.
DRV_OPEN
Уведомляет драйвер о том, что он должен быть открыт.
DRV_POWER
Уведомляет драйвер о том, что источник питания устройства будет включен или выключен.
DRV_QUERYCONFIGURE
Указывает драйверу указать, поддерживает ли он сообщение DRV_CONFIGURE .
DRV_REMOVE
Уведомляет драйвер о том, что он будет удален из системы.

unnamedParam4

32-разрядное значение для конкретного сообщения.

unnamedParam5

32-разрядное значение для конкретного сообщения.

Возвращаемое значение

Возвращает ненулевое значение при успешном выполнении или нулевое значение в противном случае.

Комментарии

Если msgDRV_OPEN, lParam1 — это строка, следующая за именем файла драйвера из файла SYSTEM.INI, а lParam2 — значение, заданное в качестве параметра lParam при вызове функции OpenDriver .

Если msgDRV_CLOSE, lParam1 и lParam2 являются теми же значениями, что и параметры lParam1 и lParam2 в вызове функции CloseDriver .

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header mmiscapi.h (включая Mmiscapi.h, Windows.h)

См. также раздел

Функции драйверов

Устанавливаемые драйверы