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