EngCreatePath function (winddi.h)

The EngCreatePath function allocates a path for the driver's temporary use.

Syntax

ENGAPI PATHOBJ * EngCreatePath();

Return value

The return value is a pointer to a PATHOBJ structure if the function is successful. Otherwise, it is null, and an error code is logged.

Remarks

The driver should delete the path, allocated by EngCreatePath, before returning to GDI from its current drawing call.

Functions that create and modify paths are provided to assist devices in clipping paths. A driver can create a path, fill it with lines and pass the path to PATHOBJ_bEnumClipLines for clipping against the complex region.

A PATHOBJ structure is a locked object, and thus should not be locked for a long time by the driver.

If the driver uses EngCreatePath to create a PATHOBJ structure, it should be deleted by using EngDeletePath as soon as the driver finishes with it.

The returned PATHOBJ structure is used in calls to PATHOBJ_bMoveTo, PATHOBJ_bPolyLineTo, PATHOBJ_vEnumStartClipLines, and PATHOBJ_bEnumClipLines

Requirements

Requirement	Value
Minimum supported client	Available in Windows 2000 and later versions of the Windows operating systems.
Target Platform	Universal
Header	winddi.h (include Winddi.h)
Library	Win32k.lib
DLL	Win32k.sys

See also

PATHOBJ

PATHOBJ_bEnumClipLines