Função KeAcquireGuardedMutexUnsafe (wdm.h)

O KeAcquireGuardedMutexUnsafe adquire um mutex protegido enquanto está dentro de uma região protegida.

Sintaxe

void KeAcquireGuardedMutexUnsafe(
  PKGUARDED_MUTEX FastMutex
);

Parâmetros

FastMutex

[in, out] Ponteiro para a estrutura de KGUARDED_MUTEX para o mutex protegido.

Retornar valor

Nenhum

Comentários

Use KeReleaseGuardedMutexUnsafe para liberar um mutex protegido adquirido com KeAcquireMutexUnsafe.

KeAcquireGuardedMutexUnsafe não coloca implicitamente o thread de chamada dentro de uma região protegida. O código entre um par KeAcquireGuardedMutexUnsafe/KeReleaseGuardedMutexUnsafe deve ser executado em IRQL = APC_LEVEL ou em uma região protegida. Para o código que não tem garantia de ser executado em uma região protegida, use KeAcquireGuardedMutex e KeReleaseGuardedMutexUnsafe.

Um mutex protegido não pode ser adquirido recursivamente: se um thread já estiver segurando o mutex quando chamar KeAcquireGuardedMutexUnsafe, o thread será deadlock.

Para obter mais informações sobre mutexes protegidos, consulte Mutexes rápidos e mutexes protegidos.

Requisitos

Requisito Valor
Servidor mínimo com suporte Windows Server 2003
Cabeçalho wdm.h
IRQL <= APC_LEVEL
Regras de conformidade de DDI HwStorPortProhibitedDIs(storport), IrqlKeApcLte1(wdm)

Confira também

KGUARDED_MUTEX

KeReleaseGuardedMutexUnsafe