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) |