Функция 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) |