Функция KeTryToAcquireGuardedMutex (wdm.h)
Подпрограмма KeTryToAcquireGuardedMutex получает защищенный мьютекс, если он доступен.
Синтаксис
BOOLEAN KeTryToAcquireGuardedMutex(
[in, out] PKGUARDED_MUTEX Mutex
);
Параметры
[in, out] Mutex
Указатель на структуру KGUARDED_MUTEX для защищенного мьютекса.
Возвращаемое значение
KeTryToAcquireGuardedMutex возвращает TRUE, если мьютекс получен, и FALSE в противном случае.
Замечания
Используйте KeReleaseGuardedMutex для освобождения мьютекса.
KeTryToAcquireGuardedMutex возвращается немедленно, независимо от того, может ли он получить мьютекс. Используйте KeAcquireGuardedMutex, чтобы поместить вызывающий поток в состояние ожидания до тех пор, пока мьютекс не станет доступным.
Поток, вызывающий KeTryToAcquireGuardedMutex неявно входит в защищенный регион, где все API отключены. Они остаются отключенными, пока поток не освобождает мьютекс с KeReleaseGuardedMutex.
Дополнительные сведения об защищенных мьютексах см. в разделе Fast Mutexes и Guarded Mutexes.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Windows Server 2003 и более поздних версиях Windows. |
| целевая платформа | Всеобщий |
| заголовка | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| библиотеки | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
| правил соответствия DDI | HwStorPortProhibitedDIs(storport), IrqlKeApcLte1(wdm) |