Função KeReadStateMutex (wdm.h)

A rotina KeReadStateMutex retorna o estado atual, sinalizado ou não sinalizado, do objeto mutex especificado.

Sintaxe

LONG KeReadStateMutex(
  [in] PRKMUTEX Mutex
);

Parâmetros

[in] Mutex

Ponteiro para um objeto mutex inicializado para o qual o chamador fornece o armazenamento.

Retornar valor

Se o valor retornado for 1, o estado do objeto mutex será sinalizado.

Comentários

Essa rotina fornece uma maneira eficiente de sondar o estado do sinal de um mutex. KeReadStateMutex lê o estado do mutex sem sincronizar seu acesso ao mutex. Não suponha que os acessos de um estado mutex por KeReadStateMutex sejam mutuamente exclusivos de acessos por rotinas, como KeReleaseMutex e KeWaitForSingleObject, que sincronizam seu acesso ao estado mutex.

Para obter mais informações sobre objetos mutex, consulte Objetos Mutex.

Requisitos

Confira também

ExInitializeFastMutex

KeInitializeMutex

KeReleaseMutex

KeWaitForSingleObject