ExTryToAcquireFastMutex 関数 (wdm.h)

  • [アーティクル]

ExTryToAcquireFastMutex ルーチンは、可能であれば、現在のスレッドへの APC を無効にして、指定された高速ミューテックスを取得します。

構文

BOOLEAN ExTryToAcquireFastMutex(
  PFAST_MUTEX FastMutex
);

パラメーター

FastMutex

[入力、出力]別のスレッドが現在所有していない場合に取得される高速ミューテックスへのポインター。

戻り値

現在のスレッドに高速ミューテックスの所有権が与えられている場合、ExTryToAcquireFastMutex は TRUE を返します。

注釈

指定された高速ミューテックスが現在所有されていない場合、 ExTryToAcquireFastMutex は、高速ミューテックスを解放するまで、APC を持つ呼び出し元の所有権を現在のスレッドに対して無効にします。

現在のスレッドが特定のミューテックスの取得を待ってから便利な作業を行う必要がある場合は、 ExAcquireFastMutex を使用します。

ExTryToAcquireFastMutex または ExAcquireFastMutex で取得された高速ミューテックスは、ExReleaseFastMutex で解放する必要があります。

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

ExTryToAcquireFastMutex の呼び出し元は、IRQL <= APC_LEVELで実行されている必要があります。 ExTryToAcquireFastMutex は、ミューテックスが取得された場合に IRQL をAPC_LEVELに設定し、 ExTryToAcquireFastMutex が戻った後も呼び出し元はAPC_LEVELで実行を続けます。 ただし、ExTryToAcquireFastMutex は、成功した場合は呼び出し元の以前の IRQL をミューテックスに保存し、呼び出し元が ExReleaseFastMutex を呼び出すと IRQL が復元されます。

要件

要件 値
サポートされている最小のクライアント Windows 2000
Header wdm.h
IRQL <= APC_LEVEL
DDI コンプライアンス規則 HwStorPortProhibitedDDIs(storport), IrqlExApcLte1(wdm)

こちらもご覧ください

FAST_MUTEX

ExAcquireFastMutex

ExInitializeFastMutex

ExReleaseFastMutex