ExAcquireFastMutexUnsafe 函式 (wdm.h)
ExAcquireFastMutexUnsafe 例程會取得呼叫線程的指定快速 Mutex。
語法
void ExAcquireFastMutexUnsafe(
PFAST_MUTEX FastMutex
);
參數
FastMutex
[in, out]呼叫端提供記憶體之 FAST_MUTEX結構的指標。 呼叫端先前已透過呼叫 exInitializeFastMutex 例程,初始化這個結構
傳回值
沒有
言論
ExAcquireFastMutexUnsafe 如果無法立即取得指定的快速 Mutex,呼叫端就會進入等候狀態。 否則,呼叫端會獲得 Mutex 的擁有權,以及 Mutex 保護之資源的獨佔存取權,直到呼叫端釋放 Mutex 為止。
呼叫 exAcquireFastMutexUnsafe 所取得的任何快速 Mutex,都必須 透過呼叫 exReleaseFastMutexUnsafe 例程來釋放。
ExAcquireFastMutex 和 ExAcquireFastMutexUnsafe 例程會導致呼叫線程封鎖,直到 mutex 可用為止。 如果另一個線程已經取得 mutex,ExTryToAcquireFastMutex 例程會立即傳回傳回傳回值 FALSE。 ExAcquireFastMutex 和 ExTryToAcquireFastMutex 先將 IRQL 提高為APC_LEVEL,再取得快速 mutex。 驅動程式應該使用 ExAcquireFastMutexUnsafe,只有在下列任一項成立時才不會引發 IRQL:
線程已在APC_LEVEL執行。
線程會在先前由呼叫 KeEnterCriticalRegion 或 FsRtlEnterFileSystem 例程輸入的重要區域內取得 mutex。
如需快速 Mutex 的詳細資訊,請參閱下列主題:
Fast Mutexes 和 Guarded Mutexes
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 2000 |
標頭 | wdm.h |
IRQL | APC_LEVEL |
DDI 合規性規則 | HwStorPortProhibitedDIs(storport) |