Funzione EngMapEvent (winddi.h)
La funzione EngMapEvent esegue il mapping di un oggetto evento in modalità utente alla modalità kernel.
Sintassi
ENGAPI PEVENT EngMapEvent(
[in] HDEV hDev,
[in] HANDLE hUserObject,
PVOID Reserved1,
PVOID Reserved2,
PVOID Reserved3
);
Parametri
[in] hDev
Gestire il dispositivo fisico associato all'evento. Si tratta dell'handle GDI passato come parametro hdev alla funzione DrvCompletePDEV del driver.
[in] hUserObject
Gestire l'evento in modalità utente di cui eseguire il mapping.
Reserved1
È riservato per l'uso del sistema e deve essere impostato su NULL.
Reserved2
È riservato per l'uso del sistema e deve essere impostato su NULL.
Reserved3
È riservato per l'uso del sistema e deve essere impostato su NULL.
Valore restituito
EngMapEvent restituisce un puntatore a un oggetto evento in caso di esito positivo. In caso contrario, restituisce NULL.
Commenti
Dopo aver eseguito correttamente il mapping dell'evento utente, EngMapEvent imposta automaticamente l'oggetto evento sullo stato segnalato, tenta di soddisfare il maggior numero possibile di attese e quindi reimposta l'oggetto evento sullo stato non firmato.
Un evento mappato fornisce un meccanismo tramite il quale un'applicazione può attendere il completamento di un'operazione grafica in modalità kernel. Il driver di visualizzazione o miniport video segnala all'applicazione quando viene eseguita l'uso della risorsa per cui è stato mappato l'evento, liberando così l'applicazione di usare la risorsa.
I driver di visualizzazione e miniport non possono attendere gli eventi mappati, ma possono impostarli o cancellarli.
Il driver può anche eseguire la propria pulizia chiamando EngUnmapEvent sull'oggetto evento restituito da EngMapEvent.
Requisiti
| Client minimo supportato | Questa funzione è disponibile in Windows XP e versioni successive. |
| Piattaforma di destinazione | Universale |
| Intestazione | winddi.h (include Winddi.h) |
| Libreria | Win32k.lib |
| DLL | Win32k.sys |