Función KeTryToAcquireGuardedMutex (wdm.h)
La rutina KeTryToAcquireGuardedMutex adquiere una exclusión mutua protegida, si está disponible.
Sintaxis
BOOLEAN KeTryToAcquireGuardedMutex(
[in, out] PKGUARDED_MUTEX Mutex
);
Parámetros
[in, out] Mutex
Puntero a la estructura de KGUARDED_MUTEX para la exclusión mutua protegida.
Valor devuelto
KeTryToAcquireGuardedMutex devuelve TRUE si se adquiere la exclusión mutua y, de lo contrario, FALSE.
Observaciones
Use KeReleaseGuardedMutex para liberar la exclusión mutua.
keTryToAcquireGuardedMutex devuelve inmediatamente, independientemente de si puede adquirir la exclusión mutua. Use KeAcquireGuardedMutex para colocar el subproceso de llamada en un estado de espera hasta que la exclusión mutua esté disponible.
Un subproceso que llama a KeTryToAcquireGuardedMutex entra implícitamente en una región protegida, donde todas las API están deshabilitadas. Permanecen deshabilitados hasta que el subproceso libera la exclusión mutua con KeReleaseGuardedMutex.
Para obtener más información sobre las exclusiones mutuas protegidas, vea Mutexes rápidos y Exclusión mutua protegida.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows Server 2003 y versiones posteriores de Windows. |
| de la plataforma de destino de | Universal |
| encabezado de | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca de | NtosKrnl.lib |
| DLL de | NtosKrnl.exe |
| irQL | <= APC_LEVEL |
| reglas de cumplimiento de DDI | HwStorPortProhibitedDIs(storport), IrqlKeApcLte1(wdm) |