Функция DriverCallback (mmiscapi.h)

  • Статья

Вызывает функцию обратного вызова, отправляет сообщение в окно или разблокирует поток. Действие зависит от значения флага уведомления. Эта функция предназначена для использования только в функции DriverProc устанавливаемого драйвера.

Синтаксис

BOOL DriverCallback(
  DWORD_PTR dwCallback,
  DWORD     dwFlags,
  HDRVR     hDevice,
  DWORD     dwMsg,
  DWORD_PTR dwUser,
  DWORD_PTR dwParam1,
  DWORD_PTR dwParam2
);

Параметры

dwCallback

Адрес функции обратного вызова, дескриптора окна или дескриптора задачи в зависимости от флага, указанного в параметре dwFlags .

dwFlags

Флаги уведомлений. Это может быть одно из следующих значений:

Значение Значение
DCB_NOSWITCH
 Системе запрещено переключение стеков. Это значение используется только в том случае, если известно, что существует достаточно места в стеке для функции обратного вызова.
DCB_FUNCTION
 Параметр dwCallback — это адрес определяемой приложением функции обратного вызова. Система отправляет сообщение обратного вызова функции обратного вызова.
DCB_WINDOW
 Параметр dwCallback — это дескриптор окна, определяемого приложением. Система отправляет последующие уведомления в окно.
DCB_TASK
 Параметр dwCallback — это дескриптор приложения или задачи. Система отправляет последующие уведомления в приложение или задачу.

hDevice

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

dwMsg

Значение сообщения.

dwUser

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

dwParam1

32-разрядный параметр, зависящий от сообщений.

dwParam2

32-разрядный параметр, зависящий от сообщений.

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

Возвращает значение TRUE в случае успешного выполнения или FALSE , если параметр недопустим или очередь сообщений задачи заполнена.

Комментарии

Клиент указывает, как уведомлять его при открытии устройства. Флаги DCB_FUNCTION и DCB_WINDOW эквивалентны слову высокого порядка соответствующих флагов CALLBACK_FUNCTION и CALLBACK_WINDOW указаны в параметре lParam2сообщения DRV_OPEN при открытии устройства.

Если уведомление выполняется с помощью функции обратного вызова, в функцию обратного вызова передаются hdrvr, msg, dwUser, dwParam1 и dwParam2 . Если уведомление выполняется с помощью окна, в окно передаются только msg, hdrvr и dwParam1 .

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header mmiscapi.h (включая Mmiscapi.h)
Библиотека Winmm.lib
DLL Winmm.dll

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

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

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