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) |