Méthode IPrintOemUni ::D ownloadFontHeader (prcomoem.h)

La IPrintOemUni::DownloadFontHeader méthode permet à un plug-in de rendu pour Unidrv d’envoyer les informations d’en-tête d’une police à une imprimante.

Syntaxe

HRESULT DownloadFontHeader(
        PDEVOBJ     pdevobj,
        PUNIFONTOBJ pUFObj,
  [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 .

[out] pdwResult

Reçoit une valeur fournie par la méthode représentant la quantité de mémoire d’imprimante, en octets, nécessaire pour stocker les informations d’en-tête de police. Si l’opération échoue, la valeur retournée doit être égale à zéro.

Valeur retournée

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

Code de retour	Description
S_OK	L’opération a réussi.
E_FAIL	L’opération a échoué
E_NOTIMPL	Cette méthode n'est pas implémentée.

Remarques

La IPrintOemUni::DownloadFontHeader méthode est utilisée pour prendre en charge les polices logicielles sur les imprimantes qui n’acceptent pas les commandes PCL . Son objectif est de permettre à un plug-in de rendu d’obtenir des informations d’en-tête de police à partir d’Unidrv et d’envoyer les informations à l’imprimante.

Les informations qui peuvent être requises pour construire un en-tête de police non PCL peuvent être obtenues par :

• Référencement de la structure UNIFONTOBJ reçue en tant qu’argument d’entrée.
• Appel de la fonction de rappel UNIFONTOBJ_GetInfo pour obtenir la structure FONTOBJ de la police.

La méthode doit envoyer les informations d’en-tête au spouleur en appelant IPrintOemDriverUni ::D rvWriteSpoolBuf.

La IPrintOemUni::DownloadFontHeader méthode est facultative. Si un plug-in de rendu implémente cette méthode, la méthode IPrintOemUni ::GetImplementedMethod du plug-in doit retourner S_OK lorsqu’elle reçoit « DownloadFontHeader » comme entrée.

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

Pour plus d’informations, consultez Gestion personnalisée des polices.

Configuration requise

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