KeReadStateEvent 函式 (wdm.h)
KeReadStateEvent 例程會傳回事件物件的目前狀態,已發出訊號或未發出訊號。
語法
LONG KeReadStateEvent(
[in] PRKEVENT Event
);
參數
[in] Event
呼叫端提供記憶體的初始化事件物件的指標。
傳回值
如果事件物件目前設定為訊號狀態,則會傳回非零值。 否則會傳回零。
備註
此例程提供有效率的方式來輪詢事件的訊號狀態。 KeReadStateEvent 會讀取事件的狀態,而不會同步處理事件的存取權。 請勿假設 KeReadStateEvent 對事件狀態的存取權互斥,例如 KeSetEvent 和 KeWaitForSingleObject,可同步處理事件狀態的存取權。
如果符合下列條件,也可以從驅動程式的中斷服務例程讀取事件的狀態,如果符合下列條件:驅動程式的事件物件可能位於其裝置擴充功能 () 中,而且存取事件的任何其他函式會將其存取與 ISR 同步處理。
如需事件對象的詳細資訊,請參閱 Event Objects。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 從 Windows 2000 開始提供。 |
目標平台 | Universal |
標頭 | wdm.h (包含 Ntddk.h) |
程式庫 | NtosKrnl.lib |
Dll | NtosKrnl.exe |
IRQL | <= DISPATCH_LEVEL |
DDI 合規性規則 | HwStorPortProhibitedDDIs (storport) 、 IrqlKeDispatchLte (wdm) |