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) |