exTryToAcquireFastMutex 函式 (wdm.h)

如果可能的話， ExTryToAcquireFastMutex 例程會取得指定的快速 Mutex，並停用目前線程的 ABC。

語法

BOOLEAN ExTryToAcquireFastMutex(
  PFAST_MUTEX FastMutex
);

參數

FastMutex

[in， out]如果快速 Mutex 目前不是由另一個線程所擁有，則為要取得之快速 Mutex 的指標。

傳回值

如果目前的線程具有快速 Mutex 的擁有權，ExTryToAcquireFastMutex 會傳回 TRUE。

備註

如果指定的快速 mutex 目前未擁有， 則 ExTryToAcquireFastMutex 會將呼叫者擁有權提供給目前已停用的線程，直到釋放快速 Mutex 為止。

如果目前的線程必須等候取得指定的 mutex，才能執行有用的工作，請使用 ExAcquireFastMutex 。

任何使用 ExTryToAcquireFastMutex 或 ExAcquireFastMutex 取得的快速 mutex 都必須使用 ExReleaseFastMutex 發行。

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

ExTryToAcquireFastMutex 的呼叫端必須在 IRQL <= APC_LEVEL執行。 如果取得 mutex，ExTryToAcquireFastMutex 會將 IRQL 設定為APC_LEVEL，而且呼叫端會在 ExTryToAcquireFastMutex 傳回之後繼續在APC_LEVEL執行。 不過，如果成功，ExTryToAcquireFastMutex 會將呼叫端先前的 IRQL 儲存在 mutex 中，並在呼叫端呼叫 ExReleaseFastMutex 時還原該 IRQL。

規格需求

需求	值
最低支援的用戶端	Windows 2000
標頭	wdm.h
IRQL	<= APC_LEVEL
DDI 合規性規則	HwStorPortProhibitedDIS (storport) 、 IrqlExApcLte1 (wdm)

另請參閱

FAST_MUTEX

ExAcquireFastMutex

ExInitializeFastMutex

ExReleaseFastMutex