Função KeTryToAcquireGuardedMutex (wdm.h)

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

Confira também

KeReleaseGuardedMutex