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

Vedi anche

DrvCompletePDEV

EngUnmapEvent