KeReadStateSemaphore 函式 （wdm.h）
KeReadStateSemaphore 例程會傳回指定號誌物件的目前狀態、訊號或未發出訊號。
語法
LONG KeReadStateSemaphore(
[in] PRKSEMAPHORE Semaphore
);
參數
[in] Semaphore
呼叫端為其提供記憶體之初始化號誌物件的指標。
傳回值
如果傳回值為零，則信號對象會設定為未發出訊號的狀態。
言論
此例程提供一個有效率的方式來輪詢信號狀態的信號狀態。 KeReadStateSemaphore 讀取旗號的狀態，而不同步處理其對旗號的存取。 請勿假設透過 KeReadStateSemaphore 來存取號誌狀態的存取，會透過例程互斥存取，例如 KeReleaseSemaphore 和 KeWaitForSingleObject，以同步存取信號狀態。
如需信號對象的詳細資訊，請參閱 Semaphore Objects。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 2000 開始提供。 |
| 目標平臺 | 普遍 |
| 標頭 | wdm.h （包括 Wdm.h、Ntddk.h、Ntifs.h） |
| 連結庫 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | 任何層級 |
| DDI 合規性規則 | HwStorPortProhibitedDIs（storport） |