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


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

Подпрограмма KeTryToAcquireGuardedMutex получает защищенный мьютекс, если он доступен.

Синтаксис

BOOLEAN KeTryToAcquireGuardedMutex(
  [in, out] PKGUARDED_MUTEX Mutex
);

Параметры

[in, out] Mutex

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

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

KeTryToAcquireGuardedMutex возвращает значение TRUE , если мьютекс получен, и false в противном случае.

Комментарии

Используйте KeReleaseGuardedMutex , чтобы освободить мьютекс.

KeTryToAcquireGuardedMutex возвращает немедленно, независимо от того, может ли он получить мьютекс. Используйте KeAcquireGuardedMutex , чтобы поместить вызывающий поток в состояние ожидания, пока мьютекс не станет доступным.

Поток, вызывающий KeTryToAcquireGuardedMutex , неявно входит в защищенную область, где отключены все APC. Они остаются отключенными, пока поток не освобождает мьютекс с KeReleaseGuardedMutex.

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

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows Server 2003 и более поздних версиях Windows.
Целевая платформа Универсальное
Верхняя часть wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL
Правила соответствия DDI HwStorPortProhibitedDIs(storport), IrqlKeApcLte1(wdm)

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

KeReleaseGuardedMutex