EngMapEvent 函式 (winddi.h)
EngMapEvent函式會將使用者模式事件物件對應至核心模式。
語法
ENGAPI PEVENT EngMapEvent(
[in] HDEV hDev,
[in] HANDLE hUserObject,
PVOID Reserved1,
PVOID Reserved2,
PVOID Reserved3
);
參數
[in] hDev
與事件相關聯的實體裝置控制碼。 這是以 hdev 參數的形式傳遞至驅動程式 DrvCompletePDEV 函式的 GDI 控制碼。
[in] hUserObject
要對應的使用者模式事件控制碼。
Reserved1
保留供系統使用，且必須設定為 Null。
Reserved2
保留供系統使用，且必須設定為 Null。
Reserved3
保留供系統使用，且必須設定為 Null。
傳回值
EngMapEvent 會在成功時傳回事件物件的指標。 否則會傳回 Null。
備註
成功對應使用者事件之後， EngMapEvent 會自動將事件物件設定為已發出訊號的狀態、嘗試滿足盡可能多的等候，然後將事件物件重設為非簽署狀態。
對應的事件會提供機制，讓應用程式可以等候核心模式圖形作業完成。 顯示驅動程式或視訊迷你埠驅動程式會在應用程式使用事件對應的資源完成時發出訊號，藉此釋放應用程式使用資源。
顯示和迷你埠驅動程式無法等候對應的事件，但可以設定或清除它們。
驅動程式也可以在EngMapEvent所傳回的事件物件上呼叫EngUnmapEvent來執行自己的清除。
規格需求
| 最低支援的用戶端 | 此函式可在 Windows XP 和更新版本中使用。 |
| 目標平台 | Universal |
| 標頭 | winddi.h (包含 Winddi.h) |
| 程式庫 | Win32k.lib |
| Dll | Win32k.sys |