exAcquireFastMutexUnsafe 函式 (wdm.h)

發行項
02/27/2024

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，只有當下列任一項成立時：