Função KeReadStateSemaphore (wdm.h)

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

Confira também

KeInitializeSemaphore

KeReleaseSemaphore

KeWaitForSingleObject