Edit

IPrintOemUni::DownloadFontHeader method (prcomoem.h)

  • Article

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:

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)