Fonction EngStrokePath (winddi.h)
La fonction EngStrokePath demande que GDI traite un chemin spécifié.
Syntaxe
ENGAPI BOOL EngStrokePath(
SURFOBJ *pso,
PATHOBJ *ppo,
CLIPOBJ *pco,
XFORMOBJ *pxo,
BRUSHOBJ *pbo,
POINTL *pptlBrushOrg,
[in] LINEATTRS *plineattrs,
[in] MIX mix
);
Paramètres
pso
Pointeur vers une structure SURFOBJ qui décrit la surface sur laquelle dessiner.
ppo
Pointeur vers une structure PATHOBJ . Les routines de service PATHOBJ_Xxx sont fournies pour énumérer les lignes, les courbes de Bézier et d’autres données qui composent le chemin. Cela indique ce qui doit être dessiné.
pco
Pointeur vers une structure CLIPOBJ . Les routines de service CLIPOBJ_Xxx sont fournies pour énumérer la région de clip sous la forme d’un ensemble de rectangles. Si vous le souhaitez, toutes les lignes du chemin d’accès peuvent être énumérées au préalable par ce CLIPOBJ. Cela signifie que les conducteurs peuvent avoir tous leurs calculs de découpage de ligne effectués pour eux.
pxo
Pointeur vers une structure XFORMOBJ . Cela n’est nécessaire que lorsqu’une ligne géométrique large doit être dessinée. Il spécifie la transformation qui convertit les coordonnées du monde en coordonnées d’appareil. Cela est nécessaire, car le chemin est fourni en coordonnées d’appareil, mais une ligne géométrique large est en fait élargie en coordonnées mondiales.
Le pilote peut utiliser les routines de service XFORMOBJ_Xxx pour déterminer la transformation.
pbo
Pointeur vers une structure BRUSHOBJ qui spécifie le pinceau à utiliser lors du dessin du chemin.
pptlBrushOrg
Pointeur vers une structure POINTL qui contient l’origine du pinceau utilisé pour aligner le modèle de pinceau sur l’appareil.
[in] plineattrs
Pointeur vers une structure LINEATTRS . Notez que le membre elStyleState de cette structure doit être mis à jour dans le cadre de cette fonction si le style de la ligne est appliqué. Notez également que le membre ptlLastPel de la même structure doit être mis à jour si une ligne cosmétique d’une seule largeur de pixels est dessinée.
[in] mix
Spécifie comment combiner le pinceau avec la destination.
Valeur retournée
La valeur de retour est TRUE si GDI caresse le chemin. Si le pilote doit tracer le chemin, la valeur de retour est FALSE et aucune erreur n’est enregistrée. Si GDI rencontre une erreur, la valeur de retour est DDI_ERROR et un code d’erreur est journalisé.
Remarques
Le mode mixte définit la façon dont le modèle entrant doit être mélangé avec les données déjà présentes sur la surface de l’appareil. Le type de données MIX se compose de deux valeurs ROP2 empaquetées dans un seul ULONG. L’octet d’ordre inférieur définit l’opération de raster au premier plan ; l’octet suivant définit l’opération de trame d’arrière-plan. Pour plus d’informations sur les codes d’opération raster, consultez la documentation Microsoft Windows SDK.
Configuration requise
| 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 |