Fonction EngMapEvent (winddi.h)
La fonction EngMapEvent mappe un objet d’événement en mode utilisateur au mode noyau.
Syntaxe
ENGAPI PEVENT EngMapEvent(
[in] HDEV hDev,
[in] HANDLE hUserObject,
PVOID Reserved1,
PVOID Reserved2,
PVOID Reserved3
);
Paramètres
[in] hDev
Gérez l’appareil physique associé à l’événement. Il s’agit du handle GDI passé en tant que paramètre hdev à la fonction DrvCompletePDEV du pilote.
[in] hUserObject
Gérez l’événement en mode utilisateur à mapper.
Reserved1
Est réservé à l’utilisation du système et doit être défini sur NULL.
Reserved2
Est réservé à l’utilisation du système et doit être défini sur NULL.
Reserved3
Est réservé à l’utilisation du système et doit être défini sur NULL.
Valeur retournée
EngMapEvent retourne un pointeur vers un objet d’événement en cas de réussite. Dans le cas contraire, elle retourne LA VALEUR NULL.
Remarques
Une fois l’événement utilisateur correctement mappé, EngMapEvent définit automatiquement l’objet événement à l’état signalé, tente de satisfaire autant d’attentes que possible, puis réinitialise l’objet d’événement à l’état non signé.
Un événement mappé fournit un mécanisme par lequel une application peut attendre qu’une opération graphique en mode noyau se termine. Le pilote d’affichage ou le pilote de miniport vidéo signale l’application lorsqu’elle utilise la ressource pour laquelle l’événement a été mappé, ce qui libère l’application pour utiliser la ressource.
Les pilotes d’affichage et de miniport ne peuvent pas attendre les événements mappés, mais peuvent les définir ou les effacer.
Le pilote peut également effectuer son propre nettoyage en appelant EngUnmapEvent sur l’objet d’événement retourné par EngMapEvent.
Configuration requise
| Client minimal pris en charge | Cette fonction est disponible dans Windows XP et versions ultérieures. |
| Plateforme cible | Universal |
| En-tête | winddi.h (inclure Winddi.h) |
| Bibliothèque | Win32k.lib |
| DLL | Win32k.sys |