ExReleaseFastMutex 函式 (wdm.h)

發行項
02/27/2024

ExReleaseFastMutex 例程會釋放使用 ExAcquireFastMutex 或 ExTryToAcquireFastMutex 取得之快速 Mutex 的擁有權。

語法

void ExReleaseFastMutex(
  PFAST_MUTEX FastMutex
);

參數

FastMutex

[in， out]要釋放之快速 Mutex 的指標。

傳回值

無

備註

ExReleaseFastMutex 會釋放指定快速 mutex 的擁有權，並將 IRQL 設定為呼叫端在呼叫端呼叫 ExAcquireFastMutex 之前所執行的值。如果先前的 IRQL 小於APC_LEVEL，則會重新啟用將 APC 傳遞至目前的線程。

使用 ExAcquireFastMutexUnsafe 取得的 FastMutex 呼叫 ExReleaseFastMutex 是程式設計錯誤。驅動程式應該從取得它的相同線程釋放快速 Mutex。快速 Mutex 應該以與其取得的順序相反的順序發行。

如需快速 Mutex 的詳細資訊，請參閱 Fast Mutexes 和 Guarded Mutexes。

ExReleaseFastMutex 的呼叫端必須在 IRQL = APC_LEVEL執行。在大部分情況下， 在呼叫 ExReleaseFastMutex 之前，IRQL 已經設定為APC_LEVEL，因為 ExAcquireFastMutex 已經自動將 IRQL 設定為APC_LEVEL。不過，如果呼叫端在 ExAcquireFastMutex 傳回之後變更 IRQL，呼叫端必須在呼叫 ExReleaseFastMutex 之前明確將 IRQL 設定為APC_LEVEL。