Función KeAcquireGuardedMutexUnsafe (wdm.h)

El KeAcquireGuardedMutexUnsafe adquiere una exclusión mutua protegida mientras se encuentra dentro de una región protegida.

Sintaxis

C++
void KeAcquireGuardedMutexUnsafe(
  PKGUARDED_MUTEX FastMutex
);

Parámetros

FastMutex

[dentro, fuera] Puntero a la estructura KGUARDED_MUTEX para la exclusión mutua protegida.

Valor devuelto

Ninguno

Observaciones

Use KeReleaseGuardedMutexUnsafe para liberar una exclusión mutua protegida adquirida con KeAcquireMutexUnsafe.

KeAcquireGuardedMutexUnsafe no coloca implícitamente el subproceso de llamada en una región protegida. El código incluido en un KeAcquireGuardedMutexUnsafe/KeReleaseGuardedMutexUnsafe par debe ejecutarse en IRQL = APC_LEVEL o dentro de una región protegida. Para el código que no se garantiza que se ejecute dentro de una región protegida, use keAcquireGuardedMutex y KeReleaseGuardedMutexUnsafe.

Una exclusión mutua protegida no se puede adquirir de forma recursiva: si un subproceso ya contiene la exclusión mutua cuando llama a KeAcquireGuardedMutexUnsafe, el subproceso se interbloqueará.

Para obtener más información sobre las exclusiones mutuas protegidas, vea Mutexes rápidos y Exclusión mutua protegida.

Requisitos

Requisito Valor
servidor mínimo admitido Windows Server 2003
encabezado de wdm.h
irQL <= APC_LEVEL
reglas de cumplimiento de DDI HwStorPortProhibitedDIs(storport), IrqlKeApcLte1(wdm)

Consulte también

KGUARDED_MUTEX

keReleaseGuardedMutexUnsafe