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。

規格需求

另請參閱

KeReleaseGuardedMutex