Fonction DrvQueryAdvanceWidths (winddi.h)

Article
08/27/2023

La fonction DrvQueryAdvanceWidths retourne les largeurs d’avance des caractères pour un ensemble spécifié de glyphes.

Syntaxe

BOOL DrvQueryAdvanceWidths(
        DHPDEV  dhpdev,
        FONTOBJ *pfo,
        ULONG   iMode,
  [in]  HGLYPH  *phg,
  [out] PVOID   pvWidths,
        ULONG   cGlyphs
);

Paramètres

dhpdev

Gérez le PDEV de l’appareil physique qui a été précédemment retourné par DrvEnablePDEV.

pfo

Pointeur vers une structure FONTOBJ qui identifie la police instance.

iMode

Spécifie le type d’informations à fournir. Ce paramètre peut être l’une des valeurs suivantes :

Valeur	Signification
QAW_GETEASYWIDTHS	Les largeurs d’avance des caractères sont retournées sous la forme d’un tableau de 12,4 nombres à points fixes. Ce mode n’est pas utilisé si les largeurs dépassent la plage de la représentation 12.4. Cette routine doit calculer les largeurs aussi rapidement que possible. Si le calcul de la largeur d’avance des caractères d’un glyphe ne peut pas être effectué efficacement, le pilote doit écrire 0xFFFF dans la mémoire tampon pour ce glyphe. La fonction retourne DDI_ERROR si une erreur se produit, FALSE si toutes les largeurs ne peuvent pas être calculées efficacement pour ce mode, ou TRUE dans tous les autres cas.
QAW_GETWIDTHS	Les largeurs d’avance des caractères sont enregistrées sous la forme d’un tableau de 12,4 nombres à points fixes. Ce mode n’est pas utilisé si les largeurs dépassent la plage de la représentation 12.4. La fonction retourne TRUE si elle réussit.

Valeur

Signification

QAW_GETEASYWIDTHS

Les largeurs d’avance des caractères sont retournées sous la forme d’un tableau de 12,4 nombres à points fixes. Ce mode n’est pas utilisé si les largeurs dépassent la plage de la représentation 12.4. Cette routine doit calculer les largeurs aussi rapidement que possible. Si le calcul de la largeur d’avance des caractères d’un glyphe ne peut pas être effectué efficacement, le pilote doit écrire 0xFFFF dans la mémoire tampon pour ce glyphe. La fonction retourne DDI_ERROR si une erreur se produit, FALSE si toutes les largeurs ne peuvent pas être calculées efficacement pour ce mode, ou TRUE dans tous les autres cas.

QAW_GETWIDTHS

Les largeurs d’avance des caractères sont enregistrées sous la forme d’un tableau de 12,4 nombres à points fixes. Ce mode n’est pas utilisé si les largeurs dépassent la plage de la représentation 12.4. La fonction retourne TRUE si elle réussit.

[in] phg

Pointeur vers un tableau de poignées de glyphes qui spécifient les glyphes pour lesquels le pilote retournera les largeurs d’avance des caractères.

[out] pvWidths

Pointeur vers une mémoire tampon où le pilote enregistre les données.

cGlyphs

Spécifie le nombre de glyphes dans la mémoire tampon d’entrée pointée par phg.

Valeur retournée

La valeur de retour dépend de la valeur du paramètre iMode .

Configuration requise


Plateforme cible	Bureau
En-tête	winddi.h (inclure Winddi.h)

Voir aussi

DrvEnablePDEV

FONTOBJ

Partager via