Função KeAcquireGuardedMutex (wdm.h)

A rotina KeAcquireGuardedMutex adquire um mutex protegido.

Sintaxe

void KeAcquireGuardedMutex(
  PKGUARDED_MUTEX Mutex
);

Parâmetros

Mutex

[in, out] Ponteiro para a estrutura KGUARDED_MUTEX para o mutex protegido. Essa estrutura deve ter sido inicializada com KeInitializeGuardedMutex.

Retornar valor

Nenhum

Comentários

Use KeReleaseGuardedMutex para liberar um mutex adquirido com KeAcquireGuardedMutex.

Se o mutex estiver disponível, KeAcquireGuardedMutex retornará imediatamente. Caso contrário, o thread de chamada será colocado em um estado de espera até que o mutex fique disponível. Para evitar entrar em um estado de espera quando o mutex não estiver disponível, use KeTryToAcquireGuardedMutex.

Um thread que chama KeAcquireGuardedMutex entra implicitamente em uma região protegida, em que todas as APCs estão desabilitadas. Eles permanecem desabilitados até que o thread libere o mutex com KeReleaseGuardedMutex.

Um mutex protegido não pode ser adquirido recursivamente: se um thread já estiver mantendo o mutex quando chamar KeAcquireGuardedMutex, 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 da DDI	HwStorPortProhibitedDDIs(storport), IrqlKeApcLte1(wdm)

Confira também

KGUARDED_MUTEX

KeReleaseGuardedMutex