KeReadStateMutex 函式 (wdm.h)

  • 發行項

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

語法

LONG KeReadStateMutex(
  [in] PRKMUTEX Mutex
);

參數

[in] Mutex

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

傳回值

如果傳回值為 1，則會發出 mutex 物件的狀態訊號。

備註

此例程提供有效率的方式輪詢 Mutex 的訊號狀態。 KeReadStateMutex 會讀取 mutex 的狀態，而不需同步處理對 mutex 的存取。 請勿假設 KeReadStateMutex 對 mutex 狀態的存取權互斥，例如 KeReleaseMutex 和 KeWaitForSingleObject，會同步處理其對 mutex 狀態的存取。

如需 Mutex 物件的詳細資訊，請參閱 Mutex 物件。

規格需求

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

另請參閱

ExInitializeFastMutex

KeInitializeMutex

KeReleaseMutex

KeWaitForSingleObject