KeReleaseMutex 関数 (wdm.h)

[アーティクル]
08/08/2023

KeReleaseMutex ルーチンはミューテックスオブジェクトを解放し、KeReleaseMutex が制御を返すとすぐに呼び出し元が KeWaitXxx ルーチンの 1 つを呼び出すかどうかを指定します。

構文

LONG KeReleaseMutex(
  [in, out] PRKMUTEX Mutex,
  [in]      BOOLEAN  Wait
);

パラメーター

[in, out] Mutex

呼び出し元がストレージを提供する初期化されたミューテックスオブジェクトへのポインター。

[in] Wait

KeReleaseMutex の呼び出しの直後に、KeWaitXxx ルーチンの 1 つを呼び出すかどうかを指定します。 TRUE の場合、KeReleaseMutex 呼び出しの後に KeWaitForMultipleObjects、KeWaitForMutexObject、または KeWaitForSingleObject を呼び出す必要があります。詳細については、「解説」を参照してください。

戻り値

戻り値が 0 の場合、ミューテックスオブジェクトは解放され、 シグナル状態になります。

注釈

パフォーマンスを向上させるには、高速ミューテックスまたは保護されたミューテックスを使用します。詳細については、「 Mutex オブジェクトの代替方法」を参照してください。

ミューテックスオブジェクトがシグナル状態に達すると、ミューテックスオブジェクトの待機を満たそうとします。

ミューテックスオブジェクトは、現在ミューテックスを保持しているスレッドによってのみ解放できます。スレッドが保持していないミューテックスを解放しようとした場合、または IRQL = DISPATCH_LEVELでミューテックスが取得され、スレッドがDISPATCH_LEVELで実行されていない場合 (およびその逆も同様)、ルーチンはSTATUS_ABANDONEDまたはSTATUS_MUTEX_NOT_OWNED例外を発生させます。

ミューテックスオブジェクトがシグナル状態になると、そのスレッドによって保持されているミューテックスの一覧から削除されます。このリストにこれ以上エントリが含まれない場合は、スレッドの元の優先度が復元されます。

KeReleaseMutex ルーチンは、IRQL を一時的に発生させる可能性があります。 Wait パラメーターが FALSE の場合、ルーチンは戻る前に、IRQL を呼び出しの開始時の元の値に復元します。

WAIT = TRUE の場合、ルーチンは IRQL を下げずにを返します。この場合、 KeReleaseMutex 呼び出しの直後に KeWaitXxx 呼び出しが続く必要があります。 Wait = TRUE を設定すると、呼び出し元は KeReleaseMutex 呼び出しと KeWaitXxx 呼び出しの間で不要なコンテキストスイッチが発生しないようにできます。 KeWaitXxx ルーチンは、返される前に、KeReleaseMutex 呼び出しの開始時に元の値に IRQL を復元します。 IRQL では 2 つの呼び出し間のコンテキスト切り替えを無効にしますが、これらの呼び出しをアトミック操作の開始と終了として確実に使用することはできません。たとえば、これら 2 つの呼び出しの間に、別のプロセッサで同時に実行されているスレッドによって、イベントオブジェクトまたは待機のターゲットの状態が変更される可能性があります。

呼び出し元が IRQL = DISPATCH_LEVELまたは任意のスレッドコンテキストで実行している場合、KeWaitXxx への Timeout パラメーターは 0 である必要があります。

ミューテックスが再帰的に取得された場合、保持スレッドは、ミューテックスを取得した回数だけ KeReleaseMutex を呼び出して、シグナル状態に設定する必要があります。

ミューテックスオブジェクトの詳細については、「ミューテックスオブジェクト」を参照してください。

要件

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