EngUnmapEvent function (winddi.h)

The EngUnmapEvent function cleans up the kernel-mode resources allocated for a mapped user-mode event.

Syntax

ENGAPI BOOL EngUnmapEvent(
  [in] PEVENT pEvent
);

Parameters

[in] pEvent

Pointer to an event object returned from a previous call to EngMapEvent.

Return value

EngUnmapEvent returns TRUE upon success. Otherwise, it returns FALSE.

Remarks

The display driver should call EngUnmapEvent when it is notified that the process (typically EngCreateDriverObj) that created the user-mode event has terminated. The display driver can also call EngUnmapEvent to perform its own cleanup. The display and miniport drivers should not touch the event object after EngUnmapEvent has been called.

The display driver can call EngUnmapEvent only for an event object returned by EngMapEvent. It must not call this function for an event object returned by EngCreateEvent.

Requirements

Requirement Value
Minimum supported client This function is available in Windows XP and later.
Target Platform Universal
Header winddi.h (include Winddi.h)
Library Win32k.lib
DLL Win32k.sys

See also

EngCreateDriverObj

EngCreateEvent

EngMapEvent