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