KeAcquireGuardedMutex 関数 (wdm.h)
KeAcquireGuardedMutex ルーチンは、保護されたミューテックスを取得します。
構文
void KeAcquireGuardedMutex(
PKGUARDED_MUTEX Mutex
);
パラメーター
Mutex
[入力、出力]保護されたミューテックスの KGUARDED_MUTEX 構造体へのポインター。 この構造体は、KeInitializeGuardedMutexで初期化されている必要があります。
戻り値
何一つ
備考
KeReleaseGuardedMutexを使用して、KeAcquireGuardedMutexで取得したミューテックスを解放します。
ミューテックスが使用可能な場合、KeAcquireGuardedMutex はすぐに返されます。 それ以外の場合、ミューテックスが使用可能になるまで、呼び出し元のスレッドは待機状態になります。 ミューテックスが使用できないときに待機状態に入らないようにするには、KeTryToAcquireGuardedMutex使用します。
KeAcquireGuardedMutex 呼び出すスレッドは、すべての APC が無効になっている保護されたリージョンに暗黙的に入ります。 スレッドが KeReleaseGuardedMutex を使用してミューテックス解放するまで無効のままです。
保護されたミューテックスは再帰的に取得できません。KeAcquireGuardedMutex を呼び出したときにスレッドが既にミューテックス保持している場合、スレッドはデッドロックします。
保護されたミューテックスの詳細については、「高速ミューテックスと保護されたミューテックス 」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小サーバー | Windows Server 2003 |
| ヘッダー | wdm.h |
| IRQL | <= APC_LEVEL |
| DDI コンプライアンス規則 を する | HwStorPortProhibitedDDIs(storport), IrqlKeApcLte1(wdm) |