共用方式為


ExTryToAcquireFastMutex 函式 (wdm.h)

ExTryToAcquireFastMutex 例程會盡可能取得指定的快速 Mutex,並將 APC 停用至目前的線程。

語法

BOOLEAN ExTryToAcquireFastMutex(
  PFAST_MUTEX FastMutex
);

參數

FastMutex

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

傳回值

ExTryToAcquireFastMutex 傳回 true true 如果目前線程擁有快速 Mutex 的擁有權。

言論

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

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

任何 使用 exTryToAcquireFastMutexExAcquireFastMutex 取得的快速 mutex,都必須使用 ExReleaseFastMutex發行。

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

ExTryToAcquireFastMutex 的呼叫端必須在 IRQL <= APC_LEVEL 執行。 ExTryToAcquireFastMutex 取得 mutex 時,會將 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