IPrintOemUni::DownloadFontHeader method (prcomoem.h)

Article
10/21/2021

The IPrintOemUni::DownloadFontHeader method allows a rendering plug-in for Unidrv to send a font's header information to a printer.

Syntax

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

Parameters

pdevobj

Caller-supplied pointer to a DEVOBJ structure.

pUFObj

Caller-supplied pointer to a UNIFONTOBJ structure.

[out] pdwResult

Receives a method-supplied value representing the amount of printer memory, in bytes, required to store the font header information. If the operation fails, the returned value should be zero.

Return value

The method must return one of the following values.

Return code	Description
S_OK	The operation succeeded.
E_FAIL	The operation failed
E_NOTIMPL	The method is not implemented.

Remarks

The IPrintOemUni::DownloadFontHeader method is used for supporting soft fonts on printers that do not accept PCL commands. Its purpose is to allow a rendering plug-in to obtain font header information from Unidrv and to send the information to the printer.

Information that might be required for constructing a non-PCL font header can be obtained by:

Referencing the UNIFONTOBJ structure that is received as an input argument.
Calling the UNIFONTOBJ_GetInfo callback function to get the font's FONTOBJ structure.

The method should send the header information to the spooler by calling IPrintOemDriverUni::DrvWriteSpoolBuf.

The IPrintOemUni::DownloadFontHeader method is optional. If a rendering plug-in implements this method, the plug-in's IPrintOemUni::GetImplementedMethod method must return S_OK when it receives "DownloadFontHeader" as input.

If you implement the IPrintOemUni::DownloadFontHeader method, you must also implement the IPrintOemUni::DownloadCharGlyph method.

For additional information see Customized Font Management.

Requirements

Requirement	Value
Target Platform	Desktop
Header	prcomoem.h (include Prcomoem.h)

Share via