FONTOBJ_cGetGlyphs, fonction (winddi.h)

Article
08/27/2023

La fonction FONTOBJ_cGetGlyphs est un service destiné au consommateur de polices qui traduit les handles de glyphes en pointeurs vers des données de glyphe, qui sont valides jusqu’à l’appel suivant à FONTOBJ_cGetGlyphs.

Syntaxe

ULONG FONTOBJ_cGetGlyphs(
       FONTOBJ *pfo,
  [in] ULONG   iMode,
       ULONG   cGlyph,
       HGLYPH  *phg,
       PVOID   *ppvGlyph
);

Paramètres

pfo

Pointeur vers une structure FONTOBJ contenant les poignées de glyphes à traduire.

[in] iMode

Spécifie si les données seront écrites sous forme de bitmaps ou d’objets de plan. Ce paramètre peut être l’une des valeurs suivantes :

Valeur	Signification
FO_GLYPHBITS	Les données se composent de structures GLYPHBITS qui définissent les bitmaps des glyphes.
FO_PATHOBJ	Les données sont constituées de structures PATHOBJ qui définissent les contours des glyphes. Pour déterminer si le chemin doit être rempli ou tracé, le consommateur de polices doit case activée le membre flInfo de la structure IFIMETRICS. Si l’indicateur FM_INFO_RETURNS_STROKES est défini, le chemin doit être tracé ; dans le cas contraire, le chemin d’accès doit être rempli.

cGlyph

Spécifie le nombre de glyphes à traduire. La seule valeur acceptable est 1 (le code suppose 1, quelle que soit la valeur spécifiée).

phg

Pointeur vers un tableau de structures HGLYPH cGlyph fournies par le pilote.

ppvGlyph

Pointeur vers un emplacement de mémoire qui reçoit l’adresse d’une structure GLYPHDATA . Le premier membre de cette structure est une union GLYPHDEF , qui contient un pointeur vers une structure GLYPHBITS ou une structure PATHOBJ, en fonction de la valeur du paramètre iMode . Si la valeur de iMode est FO_GLYPHBITS, (ppvGlyph)->gdf contient l’adresse d’une structure GLYPHBITS. Si la valeur de iMode est FO_PATHOBJ, (ppvGlyph)->gdf contient l’adresse d’une structure PATHOBJ.

Valeur retournée

La valeur de retour est le nombre de pointeurs passés au pilote si la fonction réussit. Sinon, il est égal à zéro et un code d’erreur est journalisé.

Remarques

Cette fonction doit être utilisée si le pilote met en cache les polices.

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