Partilhar via


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.

Valor de retorno

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

Observações

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 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

Requisito Valor
de cliente com suporte mínimo Disponível a partir do Windows 2000.
da Plataforma de Destino Universal
cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
biblioteca NtosKrnl.lib
de DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
regras de conformidade de DDI HwStorPortProhibitedDIs(storport)

Consulte também

ExInitializeFastMutex

KeInitializeMutex

KeReleaseMutex

KeWaitForSingleObject