Функция EngMapEvent (winddi.h)

Функция EngMapEvent сопоставляет объект события пользовательского режима с режимом ядра.

Синтаксис

ENGAPI PEVENT EngMapEvent(
  [in] HDEV   hDev,
  [in] HANDLE hUserObject,
       PVOID  Reserved1,
       PVOID  Reserved2,
       PVOID  Reserved3
);

Параметры

[in] hDev

Дескриптор физического устройства, связанного с событием. Это дескриптор GDI, передаваемый в качестве параметра hdev в функцию DrvCompletePDEV драйвера.

[in] hUserObject

Обработка события пользовательского режима для сопоставления.

Reserved1

Зарезервировано для использования системой и должно иметь значение NULL.

Reserved2

Зарезервировано для использования системой и должно иметь значение NULL.

Reserved3

Зарезервировано для использования системой и должно иметь значение NULL.

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

EngMapEvent возвращает указатель на объект события при успешном выполнении. В противном случае возвращается значение NULL.

Комментарии

После успешного сопоставления пользовательского события EngMapEvent автоматически устанавливает для объекта события сигнальное состояние, пытается удовлетворить как можно больше ожиданий, а затем сбрасывает объект события в состояние без знака.

Сопоставленное событие предоставляет механизм, с помощью которого приложение может ожидать завершения графической операции в режиме ядра. Драйвер дисплея или видео минипорта сигнализирует приложению, когда это делается с помощью ресурса, для которого было сопоставлено событие, тем самым освобождая приложение для использования ресурса.

Драйверы дисплеев и мини-портов не могут ждать сопоставленных событий, но могут устанавливать или очищать их.

Драйвер также может выполнить собственную очистку, вызвав EngUnmapEvent для объекта события, возвращенного EngMapEvent.

Требования

Минимальная версия клиента	Эта функция доступна в Windows XP и более поздних версиях.
Целевая платформа	Универсальное
Верхняя часть	winddi.h (включая Winddi.h)
Библиотека	Win32k.lib
DLL	Win32k.sys

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

DrvCompletePDEV

EngUnmapEvent