Share via


EngUnmapEvent-Funktion (winddi.h)

Die EngUnmapEvent-Funktion bereinigt die Kernelmodusressourcen, die einem zugeordneten Benutzermodusereignis zugeordnet sind.

Syntax

ENGAPI BOOL EngUnmapEvent(
  [in] PEVENT pEvent
);

Parameter

[in] pEvent

Zeiger auf ein Ereignisobjekt, das von einem vorherigen Aufruf von EngMapEvent zurückgegeben wurde.

Rückgabewert

EngUnmapEvent gibt bei Erfolg TRUE zurück. Andernfalls wird FALSE zurückgegeben.

Hinweise

Der Anzeigetreiber sollte EngUnmapEvent aufrufen, wenn er benachrichtigt wird, dass der Prozess (in der Regel EngCreateDriverObj), der das Benutzermodusereignis erstellt hat, beendet wurde. Der Anzeigetreiber kann auch EngUnmapEvent aufrufen, um eine eigene Bereinigung durchzuführen. Die Anzeige- und Miniporttreiber sollten das Ereignisobjekt nicht berühren, nachdem EngUnmapEvent aufgerufen wurde.

Der Anzeigetreiber kann EngUnmapEvent nur für ein von EngMapEvent zurückgegebenes Ereignisobjekt aufrufen. Diese Funktion darf nicht für ein von EngCreateEvent zurückgegebenes Ereignisobjekt aufgerufen werden.

Anforderungen

Anforderung Wert
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

EngCreateDriverObj

EngCreateEvent

EngMapEvent