共用方式為


KeReadStateEvent 函式 (wdm.h)

KeReadStateEvent 例程會傳回事件物件的目前狀態、已發出訊號或未發出訊號。

語法

LONG KeReadStateEvent(
  [in] PRKEVENT Event
);

參數

[in] Event

呼叫端提供記憶體之初始化事件物件的指標。

傳回值

如果事件物件目前設定為訊號狀態,則會傳回非零值。 否則會傳回零。

言論

此例程提供有效率的方式來輪詢事件的訊號狀態。 KeReadStateEvent 讀取事件的狀態,而不會同步處理事件的存取權。 請勿假設 KeReadStateEvent 的事件狀態存取互斥,例如 KeSetEventKeWaitForSingleObject,以同步處理其事件狀態的存取權。

如果符合下列條件,您也可以從 DIRQL 的驅動程式中斷服務例程讀取事件的狀態:驅動程式的事件對像是常駐的(可能在其裝置延伸模組中),以及存取事件的任何其他函式會將其存取與 ISR 同步處理。

如需事件物件的詳細資訊,請參閱 事件物件

要求

要求 價值
最低支援的用戶端 從 Windows 2000 開始提供。
目標平臺 普遍
標頭 wdm.h (包括 Ntddk.h)
連結庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
DDI 合規性規則 HwStorPortProhibitedDIs(storport)IrqlKeDispatchLte(wdm)

另請參閱

KeClearEvent

KeInitializeEvent

KeResetEvent

KeSetEvent

KeWaitForSingleObject