Función EngMapEvent (winddi.h)
La función EngMapEvent asigna un objeto de evento en modo de usuario al modo kernel.
Sintaxis
ENGAPI PEVENT EngMapEvent(
[in] HDEV hDev,
[in] HANDLE hUserObject,
PVOID Reserved1,
PVOID Reserved2,
PVOID Reserved3
);
Parámetros
[in] hDev
Identificador del dispositivo físico asociado al evento. Este es el identificador GDI pasado como parámetro hdev a la función DrvCompletePDEV del controlador.
[in] hUserObject
Controle el evento en modo de usuario que se va a asignar.
Reserved1
Está reservado para uso del sistema y debe establecerse en NULL.
Reserved2
Está reservado para uso del sistema y debe establecerse en NULL.
Reserved3
Está reservado para uso del sistema y debe establecerse en NULL.
Valor devuelto
EngMapEvent devuelve un puntero a un objeto de evento si se ejecuta correctamente. De lo contrario, devuelve NULL.
Comentarios
Después de asignar correctamente el evento de usuario, EngMapEvent establece automáticamente el objeto de evento en el estado señalado, intenta satisfacer tantas esperas como sea posible y, a continuación, restablece el objeto de evento al estado no asignado.
Un evento asignado proporciona un mecanismo por el que una aplicación puede esperar a que se complete una operación gráfica en modo kernel. El controlador de pantalla o el controlador de minipuerto de vídeo indica a la aplicación cuando se realiza mediante el recurso para el que se asignó el evento, lo que libera la aplicación para que use el recurso.
Los controladores de pantalla y minipuerto no pueden esperar eventos asignados, pero pueden establecerlos o borrarlos.
El controlador también puede realizar su propia limpieza llamando a EngUnmapEvent en el objeto de evento devuelto por 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 |