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 |