Función ExTryToAcquireFastMutex (wdm.h)

La rutina ExTryToAcquireFastMutex adquiere la exclusión mutua rápida dada, si es posible, con LAS API en el subproceso actual deshabilitado.

Sintaxis

BOOLEAN ExTryToAcquireFastMutex(
  PFAST_MUTEX FastMutex
);

Parámetros

FastMutex

[in, out] Puntero a la exclusión mutua rápida que se va a adquirir si no pertenece actualmente a otro subproceso.

Valor devuelto

ExTryToAcquireFastMutex devuelve TRUE si el subproceso actual tiene la propiedad de la exclusión mutua rápida.

Comentarios

Si la exclusión mutua rápida determinada no está protegida actualmente, ExTryToAcquireFastMutex proporciona la propiedad del autor de la llamada con las API al subproceso actual deshabilitado hasta que libera la exclusión mutua rápida.

Use ExAcquireFastMutex si el subproceso actual debe esperar a que la adquisición de la exclusión mutua especificada pueda hacer un trabajo útil.

Cualquier exclusión mutua rápida adquirida con ExTryToAcquireFastMutex o ExAcquireFastMutex debe liberarse con ExReleaseFastMutex.

Para obtener más información sobre las exclusión mutua rápida, consulte Exclusión mutua rápida y Exclusión mutua protegida.

Los autores de llamadas de ExTryToAcquireFastMutex deben ejecutarse en IRQL <= APC_LEVEL. ExTryToAcquireFastMutex establece irQL en APC_LEVEL si se adquiere la exclusión mutua y el autor de la llamada continúa ejecutándose en APC_LEVEL después de que exTryToAcquireFastMutex devuelva. ExTryToAcquireFastMutex guarda el IRQL anterior del autor de la llamada en la exclusión mutua si se ejecuta correctamente, pero ese IRQL se restaura cuando el autor de la llamada llama a ExReleaseFastMutex.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000
Encabezado	wdm.h
IRQL	<= APC_LEVEL
Reglas de cumplimiento de DDI	HwStorPortProhibitedDIs(storport), IrqlExApcLte1(wdm)

Consulte también

FAST_MUTEX

ExAcquireFastMutex

ExInitializeFastMutex

ExReleaseFastMutex