Partilhar via


Função KeReadStateSemaphore (wdm.h)

A rotina KeReadStateSemaphore retorna o estado atual, sinalizado ou não sinalizado, do objeto 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.

Valor de retorno

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

Observações

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 KeReadStateSemaphore sejam mutuamente exclusivos de acessos por rotinas, como KeReleaseSemaphore e KeWaitForSingleObject, que sincronizam seu acesso ao estado semáforo.

Para obter mais informações sobre objetos semáforos, consulte Objetos semáforos.

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 Qualquer nível
regras de conformidade de DDI HwStorPortProhibitedDIs(storport)

Consulte também

KeInitializeSemaphore

KeReleaseSemaphore

KeWaitForSingleObject