ExTryToAcquireFastMutex 関数 (wdm.h)
ExTryToAcquireFastMutex ルーチンは、可能であれば、現在のスレッドへの APC を無効にして、指定された高速ミューテックスを取得します。
構文
BOOLEAN ExTryToAcquireFastMutex(
PFAST_MUTEX FastMutex
);
パラメーター
FastMutex
[入力、出力]別のスレッドが現在所有していない場合に取得される高速ミューテックスへのポインター。
戻り値
ExTryToAcquireFastMutex 、現在のスレッドに高速ミューテックスの所有権が与えられている場合 TRUE を返します。
備考
指定された高速ミューテックスが現在所有されていない場合、ExTryToAcquireFastMutex は、高速ミューテックスを解放するまで、無効になっている現在のスレッドに対して、API を持つ呼び出し元の所有権を付与します。
現在のスレッド 特定のミューテックスの取得を待機してから便利な作業を行う必要がある場合は、ExAcquireFastMutex を使用します。
ExTryToAcquireFastMutex または exAcquireFastMutex で取得された高速ミューテックスは、ExReleaseFastMutexで解放する必要があります。
高速ミューテックスの詳細については、「高速ミューテックスと保護されたミューテックス を参照してください。
ExTryToAcquireFastMutex の呼び出し元は、IRQL <= APC_LEVEL で実行されている必要があります。 ExTryToAcquireFastMutex 、ミューテックスが取得された場合に IRQL をAPC_LEVELに設定し、呼び出し元は ExTryToAcquireFastMutex が返 後もAPC_LEVELで実行し続けます。 ExTryToAcquireFastMutex 成功した場合は、呼び出し元の以前の IRQL をミューテックスに保存し、呼び出し元が ExReleaseFastMutex 呼び出すと、その IRQL が復元されます。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 2000 |
ヘッダー | wdm.h |
IRQL | <= APC_LEVEL |
DDI コンプライアンス規則 を する | HwStorPortProhibitedDDIs(storport), IrqlExApcLte1(wdm) |
関連項目
exAcquireFastMutexをする
ExInitializeFastMutexの
ExReleaseFastMutexをする