Función KeAcquireGuardedMutex (wdm.h)
La rutina KeAcquireGuardedMutex adquiere una exclusión mutua protegida.
Sintaxis
void KeAcquireGuardedMutex(
PKGUARDED_MUTEX Mutex
);
Parámetros
Mutex
[dentro, fuera] Puntero a la estructura KGUARDED_MUTEX para la exclusión mutua protegida. Esta estructura debe haberse inicializado con KeInitializeGuardedMutex.
Valor devuelto
Ninguno
Observaciones
Use KeReleaseGuardedMutex para liberar una exclusión mutua adquirida con KeAcquireGuardedMutex.
Si la exclusión mutua está disponible, keAcquireGuardedMutex devuelve inmediatamente. De lo contrario, el subproceso que realiza la llamada se coloca en un estado de espera hasta que la exclusión mutua esté disponible. Para evitar especificar un estado de espera cuando la exclusión mutua no esté disponible, use KeTryToAcquireGuardedMutex.
Un subproceso que llama a KeAcquireGuardedMutex 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.
Una exclusión mutua protegida no se puede adquirir de forma recursiva: si un subproceso ya contiene la exclusión mutua cuando llama a KeAcquireGuardedMutex, el subproceso interbloqueo.
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) |