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) |