Partager via

IPrintOemUni ::D ownloadCharGlyph, méthode (prcomoem.h)

  • Article

La méthode IPrintOemUni::DownloadCharGlyph permet à un plug-in de rendu pour Unidrv d’envoyer un glyphe de caractère pour une police réversible spécifiée à l’imprimante.

Syntaxe

HRESULT DownloadCharGlyph(
        PDEVOBJ     pdevobj,
        PUNIFONTOBJ pUFObj,
        HGLYPH      hGlyph,
        PDWORD      pdwWidth,
  [out] OUT DWORD   *pdwResult
);

Paramètres

pdevobj

Pointeur fourni par l’appelant vers une structure DEVOBJ.

pUFObj

Pointeur fourni par l’appelant vers une structure UNIFONTOBJ.

hGlyph

Poignée de glyphe fournie par l’appelant.

pdwWidth

Pointeur fourni par l’appelant pour recevoir la largeur fournie par la méthode du caractère.

[out] pdwResult

Reçoit une valeur fournie par la méthode représentant la quantité de mémoire de l’imprimante, en octets, requise pour stocker le glyphe de caractère. Si l’opération échoue, la valeur retournée doit être égale à zéro.

Valeur de retour

La méthode doit retourner l’une des valeurs suivantes.

Retourner le code Description
S_OK
 L’opération a réussi.
E_FAIL
 Échec de l’opération
E_NOTIMPL
 La méthode n’est pas implémentée.

Remarques

La méthode IPrintOemUni::DownloadCharGlyph est utilisée pour prendre en charge les polices réversibles sur les imprimantes qui n’acceptent pas commandes de PCL. Son objectif est d’activer un plug-in de rendu pour envoyer un glyphe de caractère à l’imprimante.

Si un plug-in de rendu implémente la méthode IPrintOemUni::DownloadCharGlyph, Unidrv appelle la méthode immédiatement après l’envoi de la chaîne de commande spécifiée par l’entrée de commande CmdSetCharCode, contenue dans le fichier de GPD de l’imprimante. (Les fichiers GPD sont décrits dans Pilote d’imprimante universelle Microsoft.) La méthode doit effectuer les opérations suivantes :

  • Appelez la fonction UNIFONTOBJ_GetInfo pour obtenir l’image de glyphe spécifiée par hGlyphe.
  • Appelez IPrintOemDriverUni ::D rvWriteSpoolBuf pour envoyer le glyphe à l’imprimante.
  • Appelez à nouveau la fonction UNIFONTOBJ_GetInfo pour obtenir la largeur du glyphe, puis stockez la largeur dans l’adresse pointée par pdwWidth.
  • Retournez la quantité de mémoire de l’imprimante requise pour stocker le glyphe en le plaçant à l’emplacement spécifié par pdwResult.
La méthode IPrintOemUni::DownloadCharGlyph est facultative. Si un plug-in de rendu implémente cette méthode, le plug-in IPrintOemUni ::GetImplementedMethod méthode doit retourner S_OK lorsqu’il reçoit « DownloadCharGlyph » comme entrée.

Si vous implémentez la méthode IPrintOemUni::DownloadCharGlyph, vous devez également implémenter la méthode IPrintOemUni ::D ownloadFontHeader.

Pour plus d’informations, consultez Personnalisation de la gestion des polices.

Exigences

Exigence Valeur
plateforme cible Bureau
d’en-tête prcomoem.h (include Prcomoem.h)