KeReadStateEvent 函式 (wdm.h)
KeReadStateEvent 例程會傳回事件物件的目前狀態、已發出訊號或未發出訊號。
語法
LONG KeReadStateEvent(
[in] PRKEVENT Event
);
參數
[in] Event
呼叫端提供記憶體之初始化事件物件的指標。
傳回值
如果事件物件目前設定為訊號狀態,則會傳回非零值。 否則會傳回零。
言論
此例程提供有效率的方式來輪詢事件的訊號狀態。 KeReadStateEvent 讀取事件的狀態,而不會同步處理事件的存取權。 請勿假設 KeReadStateEvent 的事件狀態存取互斥,例如 KeSetEvent 和 KeWaitForSingleObject,以同步處理其事件狀態的存取權。
如果符合下列條件,您也可以從 DIRQL 的驅動程式中斷服務例程讀取事件的狀態:驅動程式的事件對像是常駐的(可能在其裝置延伸模組中),以及存取事件的任何其他函式會將其存取與 ISR 同步處理。
如需事件物件的詳細資訊,請參閱 事件物件。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 從 Windows 2000 開始提供。 |
目標平臺 | 普遍 |
標頭 | wdm.h (包括 Ntddk.h) |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= DISPATCH_LEVEL |
DDI 合規性規則 | HwStorPortProhibitedDIs(storport),IrqlKeDispatchLte(wdm) |