共用方式為


EngWaitForSingleObject 函式 (winddi.h)

EngWaitForSingleObject函式會將顯示驅動程式的目前線程放入等候狀態,直到指定的事件物件設定為訊號狀態,或直到等候逾時為止。

語法

ENGAPI BOOL EngWaitForSingleObject(
  [in] PEVENT         pEvent,
  [in] PLARGE_INTEGER pTimeOut
);

參數

[in] pEvent

初始化之事件物件的指標。 這個事件物件控制碼是在先前對 EngCreateEvent的呼叫中取得。

[in] pTimeOut

(選擇性) 逾時值的指標,指定等候完成的絕對或相對時間。 負值會指定相對於目前時間的間隔。 此值應該以 100 奈秒為單位來表示。 絕對到期時間會追蹤系統時間中的任何變更;相對到期時間不會受到系統時間變更的影響。 如果 pTimeOutNull,則呼叫執行緒會維持等候狀態,直到事件物件收到訊號為止。

傳回值

EngWaitForSingleObject 會在成功時傳回 TRUE ,其中包括逾時。否則會傳回 FALSEFALSE的傳回值表示其中一個參數無效。

備註

EngWaitForSingleObject 會導致顯示驅動程式執行緒進入等候狀態。 顯示驅動程式執行緒會保持等候狀態,直到事件物件設定為訊號狀態或等候逾時為止。如果未提供逾時值,顯示驅動程式執行緒會維持等候狀態,直到事件物件設定為已發出訊號的狀態為止。

當滿足等候時,同步處理事件會自動重設為非簽署狀態。 因此,每次呼叫 EngSetEventVideoPortSetEvent時,只會滿足一個等候。 相反地,不會自動重設通知事件。

零的逾時值可讓驅動程式測試等候條件,並有條件地執行任何副作用,前提是可以立即滿足等候。

顯示驅動程式可以藉由呼叫 EngWaitForSingleObject 與事件物件,等到迷你埠驅動程式將事件物件設定為訊號狀態,以同步處理本身與視訊迷你埠驅動程式之間的繪圖作業。

驅動程式無法在從 EngMapEvent傳回的事件上呼叫EngWaitForSingleObject

規格需求

   
最低支援的用戶端 此函式可在 Windows XP 和更新版本中使用。
目標平台 Universal
標頭 winddi.h (包括 Winddi.h)
程式庫 Win32k.lib
Dll Win32k.sys

另請參閱

EngCreateEvent

EngSetEvent

VideoPortSetEvent