Função KeReadStateSemaphore (wdm.h)

  • Artigo

A rotina KeReadStateSemaphore retorna o estado atual, sinalizado ou não sinalizado, do objeto de semáforo especificado.

Sintaxe

LONG KeReadStateSemaphore(
  [in] PRKSEMAPHORE Semaphore
);

Parâmetros

[in] Semaphore

Ponteiro para um objeto de semáforo inicializado para o qual o chamador fornece o armazenamento.

Retornar valor

Se o valor retornado for zero, o objeto de semáforo será definido como um estado não sinalizado.

Comentários

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

Para obter mais informações sobre objetos de semáforo, consulte Objetos semaphore.

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 Qualquer nível
Regras de conformidade da DDI HwStorPortProhibitedDDIs(storport)

Confira também

KeInitializeSemaphore

KeReleaseSemaphore

KeWaitForSingleObject