Função EngMapEvent (winddi.h)

A função EngMapEvent mapeia um objeto de evento do modo usuário para o modo kernel.

Sintaxe

ENGAPI PEVENT EngMapEvent(
  [in] HDEV   hDev,
  [in] HANDLE hUserObject,
       PVOID  Reserved1,
       PVOID  Reserved2,
       PVOID  Reserved3
);

Parâmetros

[in] hDev

Manipule para o dispositivo físico associado ao evento. Esse é o identificador GDI passado como o parâmetro hdev para a função DrvCompletePDEV do driver.

[in] hUserObject

Manipule para o evento de modo de usuário a ser mapeado.

Reserved1

É reservado para uso do sistema e deve ser definido como NULL.

Reserved2

É reservado para uso do sistema e deve ser definido como NULL.

Reserved3

É reservado para uso do sistema e deve ser definido como NULL.

Valor retornado

EngMapEvent retorna um ponteiro para um objeto de evento com êxito. Caso contrário, ele retornará NULL.

Comentários

Depois de mapear com êxito o evento de usuário, o EngMapEvent define automaticamente o objeto de evento para o estado sinalizado, tenta satisfazer o maior número possível de esperas e redefine o objeto de evento para o estado não atribuído.

Um evento mapeado fornece um mecanismo pelo qual um aplicativo pode aguardar a conclusão de uma operação gráfica no modo kernel. O driver de exibição ou o driver de miniporto de vídeo sinaliza o aplicativo quando ele é feito usando o recurso para o qual o evento foi mapeado, liberando assim o aplicativo para usar o recurso.

Os drivers de exibição e de miniporto não podem esperar por eventos mapeados, mas podem defini-los ou desmarcá-los.

O driver também pode executar sua própria limpeza chamando EngUnmapEvent no objeto de evento retornado por EngMapEvent.

Requisitos

Confira também

DrvCompletePDEV

EngUnmapEvent