Fonction de rappel PFNGETINFO (printoem.h)

  • Article

La fonction de rappel UNIFONTOBJ_GetInfo est fournie par le pilote Unidrv afin que les plug-ins de rendu puissent obtenir des informations sur la police ou le glyphe.

Syntaxe

PFNGETINFO Pfngetinfo;

BOOL Pfngetinfo(
  _UNIFONTOBJ *unnamedParam1,
  DWORD unnamedParam2,
  PVOID unnamedParam3,
  DWORD unnamedParam4,
  PDWORD unnamedParam5
)
{...}

Paramètres

unnamedParam1

Pointeur vers la structure UNIFONTOBJ reçue par la fonction qui effectue le rappel à UNIFONTOBJ_GetInfo. Fourni par l’appelant.

unnamedParam2

Spécifie la taille, en octets, de la mémoire tampon pointée par pData. Fourni par l’appelant.

unnamedParam3

Pointeur vers une structure, comme indiqué dans le tableau suivant. Fourni par l’appelant.

dwInfoID Value Pdata Structure
UFO_GETINFO_FONTOBJ GETINFO_FONTOBJ
UFO_GETINFO_GLYPHBITMAP GETINFO_GLYPHBITMAP
UFO_GETINFO_GLYPHSTRING GETINFO_GLYPHSTRING
UFO_GETINFO_GLYPHWIDTH GETINFO_GLYPHWIDTH
UFO_GETINFO_MEMORY GETINFO_MEMORY
UFO_GETINFO_STDVARIABLE GETINFO_STDVAR

Pour plus d’informations, consultez le tableau de la section Remarques .

unnamedParam4

Spécifie le type de structure pointé vers pData. Fourni par l’appelant. Pour plus d’informations, consultez le tableau de la section Remarques .

unnamedParam5

Pointeur vers un emplacement qui reçoit la taille minimale de mémoire tampon, en octets, requise pour contenir la structure identifiée par dwInfoID. Fourni par l’appelant.

Valeur retournée

Retourne une valeur BOOL . Si l’opération réussit, la fonction retourne TRUE. Sinon, il retourne FALSE.

Remarques

La fonction de rappel UNIFONTOBJ_GetInfo permet à un plug-in de rendu de rappeler dans Unidrv pour obtenir des informations de police ou de glyphe à partir de GDI, nécessaires pour gérer les opérations de gestion des polices personnalisées .

Un plug-in de rendu reçoit l’adresse de la fonction UNIFONTOBJ_GetInfo dans la structure UNIFONTOBJ qui est passée aux méthodes de personnalisation de police.

Le type d’informations retournées par la fonction dépend des arguments d’entrée. L’appelant fournit des valeurs pour dwInfoID, pData et dwDataSize pour indiquer le type d’informations souhaitées. Le tableau suivant récapitule les types d’informations retournées. Pour plus d’informations, consultez les descriptions de structure.

Pdata Structure Informations retournées
GETINFO_FONTOBJ Structure FONTOBJ décrivant la police actuelle.
GETINFO_GLYPHBITMAP Une image bitmap de glyphe unique.
GETINFO_GLYPHSTRING Tableau de spécificateurs de glyphes dans un format spécifié.
GETINFO_GLYPHWIDTH Largeur totale d’un ensemble de glyphes.
GETINFO_MEMORY Quantité de mémoire d’imprimante disponible restante.
GETINFO_STDVAR Valeur actuelle d’une ou plusieurs variables standard d’Unidrv.

Si la mémoire tampon décrite par pData et dwDataSize est trop petite pour recevoir la structure indiquée par dwInfoID, la fonction charge la taille de mémoire tampon requise dans l’emplacement pointé par pcbNeeded et retourne FALSE.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête printoem.h (inclure Printoem.h)