EngWaitForSingleObject 函式 (winddi.h)
EngWaitForSingleObject函式會將顯示驅動程式的目前線程放入等候狀態,直到指定的事件物件設定為訊號狀態,或直到等候逾時為止。
語法
ENGAPI BOOL EngWaitForSingleObject(
[in] PEVENT pEvent,
[in] PLARGE_INTEGER pTimeOut
);
參數
[in] pEvent
初始化之事件物件的指標。 這個事件物件控制碼是在先前對 EngCreateEvent的呼叫中取得。
[in] pTimeOut
(選擇性) 逾時值的指標,指定等候完成的絕對或相對時間。 負值會指定相對於目前時間的間隔。 此值應該以 100 奈秒為單位來表示。 絕對到期時間會追蹤系統時間中的任何變更;相對到期時間不會受到系統時間變更的影響。 如果 pTimeOut 為 Null,則呼叫執行緒會維持等候狀態,直到事件物件收到訊號為止。
傳回值
EngWaitForSingleObject 會在成功時傳回 TRUE ,其中包括逾時。否則會傳回 FALSE。 FALSE的傳回值表示其中一個參數無效。
備註
EngWaitForSingleObject 會導致顯示驅動程式執行緒進入等候狀態。 顯示驅動程式執行緒會保持等候狀態,直到事件物件設定為訊號狀態或等候逾時為止。如果未提供逾時值,顯示驅動程式執行緒會維持等候狀態,直到事件物件設定為已發出訊號的狀態為止。
當滿足等候時,同步處理事件會自動重設為非簽署狀態。 因此,每次呼叫 EngSetEvent 或 VideoPortSetEvent時,只會滿足一個等候。 相反地,不會自動重設通知事件。
零的逾時值可讓驅動程式測試等候條件,並有條件地執行任何副作用,前提是可以立即滿足等候。
顯示驅動程式可以藉由呼叫 EngWaitForSingleObject 與事件物件,等到迷你埠驅動程式將事件物件設定為訊號狀態,以同步處理本身與視訊迷你埠驅動程式之間的繪圖作業。
驅動程式無法在從 EngMapEvent傳回的事件上呼叫EngWaitForSingleObject。
規格需求
最低支援的用戶端 | 此函式可在 Windows XP 和更新版本中使用。 |
目標平台 | Universal |
標頭 | winddi.h (包括 Winddi.h) |
程式庫 | Win32k.lib |
Dll | Win32k.sys |