Export (0) Print
Expand All
Expand Minimize

EngCreatePath function

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

Syntax


PATHOBJ* EngCreatePath(void);

Parameters

This function has no parameters.

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

Version

Available in Windows 2000 and later versions of the Windows operating systems.

Header

Winddi.h (include Winddi.h)

Library

Win32k.lib

DLL

Win32k.sys

See also

PATHOBJ
PATHOBJ_bEnumClipLines

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft