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 で使用できます。 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
| ライブラリ | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
| DDI コンプライアンス規則 を する | HwStorPortProhibitedDDIs(storport), IrqlKeApcLte1(wdm) |