KeReadStateSemaphore 函式 (wdm.h)

KeReadStateSemaphore 例程會傳回指定號號物件的目前狀態，訊號或未發出訊號。

語法

LONG KeReadStateSemaphore(
  [in] PRKSEMAPHORE Semaphore
);

參數

[in] Semaphore

呼叫端為其提供記憶體之初始化號誌物件的指標。

傳回值

如果傳回值為零，旗號對象會設定為未發出訊號的狀態。

備註

此例程提供有效率的方式輪詢號號號狀態。 KeReadStateSemaphore 會讀取號誌的狀態，而不同步處理其對號誌的存取。 請勿假設 KeReadStateSemaphore 所存取的號志狀態互斥存取，例如 KeReleaseSemaphore 和 KeWaitForSingleObject，其會同步處理其對號志狀態的存取。

如需號誌對象的詳細資訊，請參閱 旗號物件。

規格需求

需求	值
最低支援的用戶端	從 Windows 2000 開始提供。
目標平台	Universal
標頭	wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	任何層級
DDI 合規性規則	HwStorPortProhibitedDIS (storport)

另請參閱

KeInitializeSemaphore

KeReleaseSemaphore

KeWaitForSingleObject