ExAcquireFastMutex 函式 (wdm.h)
ExAcquireFastMutex 例程會取得指定的快速 Mutex,且 API 已停用目前的線程。
語法
void ExAcquireFastMutex(
PFAST_MUTEX FastMutex
);
參數
FastMutex
[in, out]初始化之快速 Mutex 的指標,呼叫端會提供記憶體。
傳回值
沒有
言論
ExAcquireFastMutex 如果無法立即取得指定的快速 Mutex,呼叫端就會進入等候狀態。 否則,呼叫端會將快速 Mutex 的擁有權提供給停用目前線程的快速 Mutex,直到它釋放快速 Mutex 為止。
如果目前的線程可以在等候取得指定的 mutex 之前執行其他工作,請使用 ExTryToAcquireFastMutex。
任何使用 ExAcquireFastMutex 或 ExTryToAcquireFastMutex 取得的快速 Mutex,都必須使用 ExReleaseFastMutex發行。
如需快速 Mutex 的詳細資訊,請參閱 Fast Mutexes 和 Guarded Mutexes。
ExAcquireFastMutex 的呼叫端必須在 IRQL <= APC_LEVEL 執行。 ExAcquireFastMutex 會將 IRQL 設定為 APC_LEVEL,而呼叫者會在 ExAcquireFastMutex 傳回之後繼續在APC_LEVEL執行。 ExAcquireFastMutex 會將呼叫端先前的 IRQL 儲存在 mutex 中,而且當呼叫端叫用 exReleaseFastMutex 時,就會還原 IRQL。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 2000 |
標頭 | wdm.h |
IRQL | <= APC_LEVEL |
DDI 合規性規則 | HwStorPortProhibitedDIs(storport),IrqlExApcLte1(wdm) |