Fonction EngCreatePath (winddi.h)

La fonction EngCreatePath alloue un chemin pour l’utilisation temporaire du pilote.

Syntaxe

ENGAPI PATHOBJ * EngCreatePath();

Valeur de retour

La valeur de retour est un pointeur vers une structure PATHOBJ si la fonction réussit. Sinon, elle est null et un code d’erreur est journalisé.

Remarques

Le pilote doit supprimer le chemin, alloué par EngCreatePath, avant de revenir à GDI à partir de son appel de dessin actuel.

Les fonctions qui créent et modifient des chemins d’accès sont fournies pour aider les appareils à couper les chemins. Un pilote peut créer un chemin, le remplir de lignes et passer le chemin à PATHOBJ_bEnumClipLines pour le découpage sur la région complexe.

Une structure PATHOBJ est un objet verrouillé et ne doit donc pas être verrouillée pendant une longue période par le pilote.

Si le pilote utilise EngCreatePath pour créer une structure PATHOBJ, elle doit être supprimée à l’aide d’EngDeletePath dès que le pilote a terminé avec.

La structure PATHOBJ retournée est utilisée dans les appels à PATHOBJ_bMoveTo, PATHOBJ_bPolyLineTo, PATHOBJ_vEnumStartClipLines et PATHOBJ_bEnumClipLines

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Universal
En-tête	winddi.h (inclure Winddi.h)
Bibliothèque	Win32k.lib
DLL	Win32k.sys

Voir aussi

PATHOBJ

PATHOBJ_bEnumClipLines