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)

另請參閱

KeClearEvent

KeInitializeEvent

KeResetEvent

KeSetEvent

KeWaitForSingleObject