Share via

EngMapEvent-Funktion (winddi.h)

  • Artikel

Die EngMapEvent-Funktion ordnet ein Benutzermodusereignisobjekt dem Kernelmodus zu.

Syntax

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

Parameter

[in] hDev

Behandeln Sie das physische Gerät, das dem Ereignis zugeordnet ist. Dies ist das GDI-Handle, das als hdev-Parameter an die DrvCompletePDEV-Funktion des Treibers übergeben wird.

[in] hUserObject

Behandeln Sie das zu zuordnende Benutzermodusereignis.

Reserved1

Ist für die Systemverwendung reserviert und muss auf NULL festgelegt werden.

Reserved2

Ist für die Systemverwendung reserviert und muss auf NULL festgelegt werden.

Reserved3

Ist für die Systemverwendung reserviert und muss auf NULL festgelegt werden.

Rückgabewert

EngMapEvent gibt bei Erfolg einen Zeiger auf ein Ereignisobjekt zurück. Andernfalls wird NULL zurückgegeben.

Hinweise

Nach der erfolgreichen Zuordnung des Benutzerereignisses legt EngMapEvent das Ereignisobjekt automatisch auf den signalierten Zustand fest, versucht, so viele Wartezeiten wie möglich zu erfüllen, und setzt das Ereignisobjekt dann auf den nicht signalierten Zustand zurück.

Ein zugeordnetes Ereignis stellt einen Mechanismus bereit, mit dem eine Anwendung warten kann, bis ein Grafikvorgang im Kernelmodus abgeschlossen ist. Der Anzeigetreiber oder Videominiporttreiber signalisiert der Anwendung, wenn dies mit der Ressource erfolgt, für die das Ereignis zugeordnet wurde, und gibt der Anwendung so frei, die Ressource zu verwenden.

Anzeige- und Miniporttreiber können nicht auf zugeordnete Ereignisse warten, sondern sie festlegen oder löschen.

Der Treiber kann auch eine eigene Bereinigung durchführen, indem er EngUnmapEvent für das von EngMapEvent zurückgegebene Ereignisobjekt aufruft.

Anforderungen

   
Unterstützte Mindestversion (Client) Diese Funktion ist in Windows XP und höher verfügbar.
Zielplattform Universell
Header winddi.h (einschließlich Winddi.h)
Bibliothek Win32k.lib
DLL Win32k.sys

Weitere Informationen

DrvCompletePDEV

EngUnmapEvent