Función EngWaitForSingleObject (winddi.h)
La función EngWaitForSingleObject coloca el subproceso actual del controlador de pantalla en un estado de espera hasta que el objeto de evento especificado se establece en el estado señalado o hasta que se agota el tiempo de espera.
Sintaxis
ENGAPI BOOL EngWaitForSingleObject(
[in] PEVENT pEvent,
[in] PLARGE_INTEGER pTimeOut
);
Parámetros
[in] pEvent
Puntero a un objeto de evento inicializado. Este identificador de objeto de evento se obtuvo en una llamada anterior a EngCreateEvent.
[in] pTimeOut
(Opcional) Puntero a un valor de tiempo de espera que especifica el tiempo absoluto o relativo en el que se va a completar la espera. Un valor negativo especifica un intervalo relativo a la hora actual. El valor debe expresarse en unidades de 100 nanosegundos. Los tiempos de expiración absolutos realizan un seguimiento de los cambios en la hora del sistema; los tiempos de expiración relativos no se ven afectados por los cambios de hora del sistema. Si pTimeOut es NULL, el subproceso que realiza la llamada permanece en estado de espera hasta que se señale el objeto de evento.
Valor devuelto
EngWaitForSingleObject devuelve TRUE cuando se ha realizado correctamente, lo que incluye la repetición de un tiempo de espera. De lo contrario, devuelve FALSE. Un valor devuelto de FALSE indica que uno de los parámetros no es válido.
Comentarios
EngWaitForSingleObject hace que un subproceso del controlador de pantalla se coloque en un estado de espera. El subproceso del controlador de pantalla permanece en estado de espera hasta que el objeto de evento se establece en el estado señalado o hasta que se agota el tiempo de espera. Si no se proporciona ningún valor de tiempo de espera, el subproceso del controlador de pantalla permanece en estado de espera hasta que el objeto de evento se establece en el estado señalado.
Un evento de sincronización se restablece automáticamente al estado no asignado cuando se cumple la espera. Por lo tanto, solo se cumplirá una espera por llamada a EngSetEvent o VideoPortSetEvent. Por el contrario, un evento de notificación no se restablecerá automáticamente.
Un valor de tiempo de espera de cero permite al controlador probar la condición de espera y realizar condicionalmente los efectos secundarios siempre que la espera pueda cumplirse inmediatamente.
El controlador de pantalla puede sincronizar las operaciones de dibujo entre sí mismo y el controlador de minipuerto de vídeo llamando a EngWaitForSingleObject con un objeto de evento y esperando hasta que el controlador de miniporte establece el objeto de evento en el estado señalado.
El controlador no puede llamar a EngWaitForSingleObject en los eventos devueltos desde EngMapEvent.
Requisitos
| Cliente mínimo compatible | Esta función está disponible en Windows XP y versiones posteriores. |
| Plataforma de destino | Universal |
| Encabezado | winddi.h (incluya Winddi.h) |
| Library | Win32k.lib |
| Archivo DLL | Win32k.sys |