Función KeReadStateSemaphore (wdm.h)

La rutina KeReadStateSemaphore devuelve el estado actual, señalado o no señalado, del objeto de semáforo especificado.

Sintaxis

LONG KeReadStateSemaphore(
  [in] PRKSEMAPHORE Semaphore
);

Parámetros

[in] Semaphore

Puntero a un objeto de semáforo inicializado para el que el autor de la llamada proporciona el almacenamiento.

Valor devuelto

Si el valor devuelto es cero, el objeto de semáforo se establece en un estado no señalado.

Comentarios

Esta rutina proporciona una manera eficaz de sondear el estado de señal de un semáforo. KeReadStateSemaphore lee el estado del semáforo sin sincronizar su acceso al semáforo. No suponga que los accesos de un estado de semáforo por KeReadStateSemaphore son mutuamente excluyentes de los accesos por rutinas, como KeReleaseSemaphore y KeWaitForSingleObject, que sincronizan su acceso al estado del semáforo.

Para obtener más información sobre los objetos de semáforo, vea Objetos de semáforo.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible a partir de Windows 2000.
Plataforma de destino	Universal
Encabezado	wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	Cualquier nivel
Reglas de cumplimiento de DDI	HwStorPortProhibitedDIs(storport)

Consulte también

KeInitializeSemaphore

KeReleaseSemaphore

KeWaitForSingleObject