KeTryToAcquireGuardedMutex 函式 (wdm.h)
KeTryToAcquireGuardedMutex 例程會取得受防護的 mutex,如果有的話。
語法
BOOLEAN KeTryToAcquireGuardedMutex(
[in, out] PKGUARDED_MUTEX Mutex
);
參數
[in, out] Mutex
受防護 Mutex 之 KGUARDED_MUTEX 結構的指標。
傳回值
KeTryToAcquireGuardedMutex 會傳回 TRUE,否則會 傳回 FALSE。
言論
使用 KeReleaseGuardedMutex 來釋放 mutex。
KeTryToAcquireGuardedMutex 會立即傳回,不論是否可以取得 mutex。 使用 KeAcquireGuardedMutex,將呼叫線程置於等候狀態,直到 mutex 變成可用為止。
呼叫 KeTryToAcquireGuardedMutex 的線程, 隱含地進入受防護區域,其中會停用所有 APC。 它們會保持停用,直到線程釋放具有 KeReleaseGuardedMutex的 mutex 為止。
如需受防護 Mutex 的詳細資訊,請參閱 Fast Mutexes 和 Guarded Mutexes。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 適用於 Windows Server 2003 和更新版本的 Windows。 |
目標平臺 | 普遍 |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= APC_LEVEL |
DDI 合規性規則 | HwStorPortProhibitedDIs(storport),IrqlKeApcLte1(wdm) |