共用方式為


KeTryToAcquireGuardedMutex 函式 (wdm.h)

如果有的話, KeTryToAcquireGuardedMutex 例程會取得受防護的 mutex。

語法

BOOLEAN KeTryToAcquireGuardedMutex(
  [in, out] PKGUARDED_MUTEX Mutex
);

參數

[in, out] Mutex

受防護 Mutex 之KGUARDED_MUTEX 結構的指標。

傳回值

如果取得 Mutex,KeTryToAcquireGuardedMutex 會傳回 TRUE,否則會傳回 FALSE

備註

使用 KeReleaseGuardedMutex 釋放 mutex。

KeTryToAcquireGuardedMutex 會立即傳回,不論是否可以取得 mutex。 使用 KeAcquireGuardedMutex 將呼叫線程放入等候狀態,直到 mutex 變成可用為止。

呼叫 KeTryToAcquireGuardedMutex 的線程會隱含地進入已停用所有 APC 的受防護區域。 它們會保持停用狀態,直到線程使用 KeReleaseGuardedMutex 釋放 mutex 為止。

如需受防護 Mutex 的詳細資訊,請參閱 Fast Mutexes 和 Guarded Mutex。

規格需求

需求
最低支援的用戶端 適用於 Windows Server 2003 和更新版本的 Windows。
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL <= APC_LEVEL
DDI 合規性規則 HwStorPortProhibitedDIS (storport) IrqlKeApcLte1 (wdm)

另請參閱

KeReleaseGuardedMutex