EngMapEvent-Funktion (winddi.h)
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 |