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