ExTryToAcquireFastMutex 函式 (wdm.h)
ExTryToAcquireFastMutex 例程會盡可能取得指定的快速 Mutex,並將 APC 停用至目前的線程。
語法
BOOLEAN ExTryToAcquireFastMutex(
PFAST_MUTEX FastMutex
);
參數
FastMutex
[in, out]如果目前不是另一個線程所擁有的快速 Mutex 指標,則為要取得的指標。
傳回值
ExTryToAcquireFastMutex 傳回 true true 如果目前線程擁有快速 Mutex 的擁有權。
言論
如果指定的快速 mutex 目前未擁有,ExTryToAcquireFastMutex 將呼叫端擁有權提供給停用的目前線程,直到它釋放快速 Mutex 為止。
如果目前線程必須等候取得指定的 mutex,才能執行有用的工作,請使用 ExAcquireFastMutex。
任何 使用 exTryToAcquireFastMutex 或 ExAcquireFastMutex 取得的快速 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) |