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

  • Статья

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

Синтаксис

void KeAcquireGuardedMutexUnsafe(
  PKGUARDED_MUTEX FastMutex
);

Параметры

FastMutex

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

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

None

Remarks

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

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

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

Дополнительные сведения о защищенных мьютексах см. в разделе Быстрые мьютексы и Защищенные мьютексы.

Требования

Требование Значение
Минимальная версия сервера Windows Server 2003
Верхняя часть wdm.h
IRQL <= APC_LEVEL
Правила соответствия DDI HwStorPortProhibitedDIs(storport), IrqlKeApcLte1(wdm)

См. также раздел

KGUARDED_MUTEX

KeReleaseGuardedMutexUnsafe