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 |