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

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

Confira também

ExInitializeFastMutex

KeInitializeMutex

KeReleaseMutex

KeWaitForSingleObject