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 FALSE en caso contrario.
Comentarios
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 exclusión mutuas protegidas, vea Exclusión mutua rápida y Exclusión mutua protegida.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows Server 2003 y versiones posteriores de Windows. |
| Plataforma de destino | Universal |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
| Reglas de cumplimiento de DDI | HwStorPortProhibitedDIs(storport), IrqlKeApcLte1(wdm) |