Функция EngCreatePath (winddi.h)

Функция EngCreatePath выделяет путь для временного использования драйвера.

Синтаксис

ENGAPI PATHOBJ * EngCreatePath();

Возвращаемое значение

Возвращаемое значение является указателем на структуру PATHOBJ , если функция выполнена успешно. В противном случае он имеет значение NULL и регистрируется код ошибки.

Комментарии

Драйвер должен удалить путь, выделенный EngCreatePath, прежде чем вернуться в GDI из текущего вызова рисования.

Функции, которые создают и изменяют пути, предоставляются для помощи устройствам в обрезке путей. Драйвер может создать путь, заполнить его линиями и передать путь к PATHOBJ_bEnumClipLines для обрезки по сложной области.

Структура PATHOBJ является заблокированным объектом и поэтому не должна быть заблокирована драйвером в течение длительного времени.

Если драйвер использует EngCreatePath для создания структуры PATHOBJ, он должен быть удален с помощью EngDeletePath сразу после завершения работы драйвера.

Возвращаемая структура PATHOBJ используется в вызовах PATHOBJ_bMoveTo, PATHOBJ_bPolyLineTo, PATHOBJ_vEnumStartClipLines и PATHOBJ_bEnumClipLines

Требования

См. также раздел

PATHOBJ

PATHOBJ_bEnumClipLines