Função KeTryToAcquireGuardedMutex (wdm.h)

  • Artigo

A rotina KeTryToAcquireGuardedMutex adquire um mutex protegido, se disponível.

Sintaxe

BOOLEAN KeTryToAcquireGuardedMutex(
  [in, out] PKGUARDED_MUTEX Mutex
);

Parâmetros

[in, out] Mutex

Ponteiro para a estrutura de KGUARDED_MUTEX para o mutex protegido.

Retornar valor

KeTryToAcquireGuardedMutex retornaráTRUE se o mutex for adquirido e FALSE caso contrário.

Comentários

Use KeReleaseGuardedMutex para liberar o mutex.

KeTryToAcquireGuardedMutex retorna imediatamente, independentemente de poder adquirir o mutex. Use KeAcquireGuardedMutex para colocar o thread de chamada em um estado de espera até que o mutex fique disponível.

Um thread que chama KeTryToAcquireGuardedMutex implicitamente entra 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.

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows Server 2003 e versões posteriores do Windows.
Plataforma de Destino Universal
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL
Regras de conformidade de DDI HwStorPortProhibitedDIs(storport), IrqlKeApcLte1(wdm)

Confira também

KeReleaseGuardedMutex