Функция 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

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

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

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