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