共用方式為


KeReadStateEvent 函式 (wdm.h)

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

語法

LONG KeReadStateEvent(
  [in] PRKEVENT Event
);

參數

[in] Event

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

傳回值

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

備註

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

如果符合下列條件,也可以從驅動程式的中斷服務例程讀取事件的狀態,如果符合下列條件:驅動程式的事件物件可能位於其裝置擴充功能 () 中,而且存取事件的任何其他函式會將其存取與 ISR 同步處理。

如需事件對象的詳細資訊,請參閱 Event Objects

規格需求

需求
最低支援的用戶端 從 Windows 2000 開始提供。
目標平台 Universal
標頭 wdm.h (包含 Ntddk.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
DDI 合規性規則 HwStorPortProhibitedDDIs (storport) IrqlKeDispatchLte (wdm)

另請參閱

KeClearEvent

KeInitializeEvent

KeResetEvent

KeSetEvent

KeWaitForSingleObject