KeAcquireGuardedMutex 函式 (wdm.h)
KeAcquireGuardedMutex 例程會取得受防護的 Mutex。
語法
void KeAcquireGuardedMutex(
PKGUARDED_MUTEX Mutex
);
參數
Mutex
[in, out]受防護 Mutex 之 KGUARDED_MUTEX 結構的指標。 此結構必須使用 KeInitializeGuardedMutex初始化。
傳回值
沒有
言論
使用 KeReleaseGuardedMutex 來釋放使用 KeAcquireGuardedMutex取得的 mutex。
如果 mutex 可用,KeAcquireGuardedMutex 會立即傳回。 否則,呼叫線程會處於等候狀態,直到 Mutex 變成可用為止。 若要避免在 mutex 無法使用時進入等候狀態,請使用 KeTryToAcquireGuardedMutex。
呼叫 KeAcquireGuardedMutex 的線程會隱含地進入受防護區域,其中會停用所有 APC。 它們會保持停用,直到線程釋放具有 KeReleaseGuardedMutex的 mutex 為止。
無法以遞歸方式取得受防護 Mutex:如果線程在呼叫 KeAcquireGuardedMutex時已經持有 mutex,線程就會死結。
如需受防護 Mutex 的詳細資訊,請參閱 Fast Mutexes 和 Guarded Mutexes。
要求
要求 | 價值 |
---|---|
支援的最低伺服器 | Windows Server 2003 |
標頭 | wdm.h |
IRQL | <= APC_LEVEL |
DDI 合規性規則 | HwStorPortProhibitedDIs(storport),IrqlKeApcLte1(wdm) |