Поделиться через


Функция KeAcquireGuardedMutexUnsafe (wdm.h)

KeAcquireGuardedMutexUnsafe получает защищенный мьютекс во время внутри защищенного региона.

Синтаксис

void KeAcquireGuardedMutexUnsafe(
  PKGUARDED_MUTEX FastMutex
);

Параметры

FastMutex

[in, out] Указатель на структуру KGUARDED_MUTEX для защищенного мьютекса.

Возвращаемое значение

Никакой

Замечания

Используйте KeReleaseGuardedMutexUnsafe, чтобы освободить защищенный мьютекс, приобретенный с KeAcquireMutexUnsafe.

KeAcquireGuardedMutexUnsafe неявно помещает вызывающий поток в защищенный регион. Код, заключенный в пару KeAcquireGuardedMutexUnsafe/KeReleaseGuardedMutexUnsafe, должен выполняться либо в IRQL = APC_LEVEL, либо в защищенном регионе. Для кода, который не гарантируется выполнить в защищенном регионе, используйте KeAcquireGuardedMutex и KeReleaseGuardedMutexUnsafe.

Защищенный мьютекс нельзя получить рекурсивно: если поток уже держит мьютекс при вызове KeAcquireGuardedMutexUnsafe, поток будет взаимоблокировкой.

Дополнительные сведения об защищенных мьютексах см. в разделе Fast Mutexes и Guarded Mutexes.

Требования

Требование Ценность
минимальный поддерживаемый сервер Windows Server 2003
заголовка wdm.h
IRQL <= APC_LEVEL
правил соответствия DDI HwStorPortProhibitedDIs(storport), IrqlKeApcLte1(wdm)

См. также

KGUARDED_MUTEX

KeReleaseGuardedMutexUnsafe