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)

Consulte también

KeReleaseGuardedMutex