Ler em inglês

Partilhar via


Função KeAcquireGuardedMutexUnsafe (wdm.h)

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

Sintaxe

C++
void KeAcquireGuardedMutexUnsafe(
  PKGUARDED_MUTEX FastMutex
);

Parâmetros

FastMutex

[dentro, fora] Ponteiro para a estrutura KGUARDED_MUTEX para o mutex protegido.

Valor de retorno

Nenhum

Observações

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 dentro de 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 ele 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 com suporte mínimo Windows Server 2003
cabeçalho wdm.h
IRQL <= APC_LEVEL
regras de conformidade de DDI HwStorPortProhibitedDIs(storport), IrqlKeApcLte1(wdm)

Consulte também

KGUARDED_MUTEX

KeReleaseGuardedMutexUnsafe