Metodo IPrintOemUni::D ownloadFontHeader (prcomoem.h)

Articolo
02/07/2025

Il metodo IPrintOemUni::DownloadFontHeader consente a un plug-in di rendering per Unidrv di inviare le informazioni di intestazione di un tipo di carattere a una stampante.

Sintassi

HRESULT DownloadFontHeader(
        PDEVOBJ     pdevobj,
        PUNIFONTOBJ pUFObj,
  [out] OUT DWORD   *pdwResult
);

Parametri

pdevobj

Puntatore fornito dal chiamante a una struttura DEVOBJ.

pUFObj

Puntatore fornito dal chiamante a una struttura UNIFONTOBJ.

[out] pdwResult

Riceve un valore fornito dal metodo che rappresenta la quantità di memoria della stampante, in byte, necessaria per archiviare le informazioni sull'intestazione del carattere. Se l'operazione non riesce, il valore restituito deve essere zero.

Valore restituito

Il metodo deve restituire uno dei valori seguenti.

Codice restituito	Descrizione
S_OK	Operazione riuscita.
E_FAIL	Operazione non riuscita
E_NOTIMPL	Il metodo non è implementato.

Osservazioni

Il metodo IPrintOemUni::DownloadFontHeader viene usato per supportare i tipi di carattere soft nelle stampanti che non accettano comandi PCL. Il suo scopo è consentire a un plug-in di rendering di ottenere informazioni sull'intestazione del carattere da Unidrv e di inviare le informazioni alla stampante.

È possibile ottenere informazioni che potrebbero essere necessarie per costruire un'intestazione del tipo di carattere nonpcl:

Riferimento alla struttura UNIFONTOBJ ricevuta come argomento di input.
Chiamando la funzione di callback UNIFONTOBJ_GetInfo per ottenere la struttura fontOBJ del tipo di carattere.

Il metodo deve inviare le informazioni sull'intestazione allo spooler chiamando IPrintOemDriverUni::D rvWriteSpoolBuf.

Il metodo IPrintOemUni::DownloadFontHeader è facoltativo. Se un plug-in di rendering implementa questo metodo, il metodo IPrintOemUni::GetImplementedMethod deve restituire S_OK quando riceve "DownloadFontHeader" come input.

Se si implementa il metodo IPrintOemUni::DownloadFontHeader, è necessario implementare anche il metodo IPrintOemUni::D ownloadCharGlyph.

Per altre informazioni, vedere gestione dei tipi di carattere personalizzata.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	prcomoem.h (include Prcomoem.h)

Condividi tramite