IPrintOemUni::DownloadFontHeader method

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]  DWORD *pdwResult
);

Parameters

pdevobj

Caller-supplied pointer to a DEVOBJ structure.

pUFObj

Caller-supplied pointer to a UNIFONTOBJ structure.

pdwResult [out]

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 codeDescription
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

Header

Prcomoem.h (include Prcomoem.h)

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft