DrvGetGlyphMode, fonction (winddi.h)

Article
03/04/2024

La fonction DrvGetGlyphMode indique à GDI comment mettre en cache les informations de glyphe.

Syntaxe

ULONG DrvGetGlyphMode(
  [in] DHPDEV  unnamedParam1,
  [in] FONTOBJ *unnamedParam2
);

Paramètres

[in] unnamedParam1

Gérez la structure PDEV d’un appareil physique.

[in] unnamedParam2

Pointeur vers une structure FONTOBJ qui peut être interrogée pour rechercher la taille de police, la transformation et d’autres attributs de police.

Valeur retournée

DrvGetGlyphMode retourne l’une des valeurs suivantes :

Code de retour	Description
FO_GLYPHBITS	GDI doit mettre en cache toutes les données de glyphe pour cette police.
FO_HGLYPHS	L’appareil met en cache les polices par lui-même, de sorte que GDI doit mettre en cache uniquement les poignées de glyphes pour cette police.
FO_PATHOBJ	GDI doit mettre en cache les structures PATHOBJ pour cette police.

Remarques

GDI appelle la routine DrvGetGlyphMode d’un pilote pour déterminer la plage d’informations de police qui doivent être mises en cache pour une police particulière ; autrement dit, DrvGetGlyphMode détermine ce que GDI stocke dans son cache de polices. Un appareil qui met en cache les polices par lui-même doit retourner FO_HGLYPHS afin de réduire les exigences de stockage pour la police.

GDI appelle DrvGetGlyphMode pour chaque réalisation de police. Par exemple, un pilote peut souhaiter télécharger des contours pour les tailles de point supérieures à 12 points, mais des images raster pour les polices plus petites. Toutefois, GDI se réserve le droit de refuser cette demande.

Le pilote doit case activée le bit RASTER_FONTTYPE du membre flFontType de la structure FONTOBJ pour déterminer la forme réelle des glyphes. Si ce bit est défini, GDI envoie des bitmaps ; sinon, il envoie des structures PATHOBJ .

Au moment de l’appel à DrvGetGlyphMode, le FONTOBJ associé n’est pas entièrement fonctionnel. GDI garantit uniquement que la structure IFIMETRICS et la transformation notionnelle à appareil sont correctes.

DrvGetGlyphMode est une fonction de pilote facultative. Si cette fonction n’est pas fournie, GDI stocke les polices raster par défaut.