KeTryToAcquireGuardedMutex 関数 (wdm.h)

KeTryToAcquireGuardedMutex ルーチンは、保護されたミューテックス (使用可能な場合) を取得します。

構文

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

[in, out] Mutex

保護されたミューテックスの KGUARDED_MUTEX 構造体へのポインター。

ミューテックスが取得された場合は KeTryToAcquireGuardedMutex が TRUE を返し、それ以外の場合は FALSE を返します。

KeReleaseGuardedMutex を使用してミューテックスを解放します。

KeTryToAcquireGuardedMutex は、ミューテックスを取得できるかどうかに関係なく、直ちにを返します。呼び出し元のスレッドをミューテックスが使用可能になるまで待機状態にするには、 KeAcquireGuardedMutex を使用します。

KeTryToAcquireGuardedMutex を呼び出すスレッドは、すべての APC が無効になっている保護されたリージョンに暗黙的に入ります。スレッドが KeReleaseGuardedMutex を使用してミューテックスを解放するまで、これらは無効のままです。

保護されたミューテックスの詳細については、「高速ミューテックス」と「保護されたミューテックス」を参照してください。

要件	値
サポートされている最小のクライアント	Windows Server 2003 以降のバージョンの Windows で使用できます。
対象プラットフォーム	ユニバーサル
Header	wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	<= APC_LEVEL
DDI コンプライアンス規則	HwStorPortProhibitedDDIs(storport), IrqlKeApcLte1(wdm)