IPrintOemUni::TTDownloadMethod method (prcomoem.h)

Article
10/21/2021

The IPrintOemUni::TTDownloadMethod method enables a rendering plug-in to indicate the format that Unidrv should use for a specified TrueType soft font.

Syntax

HRESULT TTDownloadMethod(
        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 one of the following method-supplied constant values:

Value	Definition
TTDOWNLOAD_BITMAP	Unidrv should download the specified font as bitmaps.
TTDOWNLOAD_DONTCARE	Unidrv can select the font format.
TTDOWNLOAD_GRAPHICS	Unidrv should print TrueType fonts as graphics, instead of downloading the font.
TTDOWNLOAD_TTOUTLINE	Unidrv should download the specified font as outlines. For more information, see the following Remarks section.

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::TTDownloadMethod method's purpose is to allow a rendering plug-in to specify a printer's preferred format for a specified TrueType soft font.

If a rendering plug-in implements the IPrintOemUni::TTDownloadMethod method, Unidrv calls the method each time it is ready to send a TrueType font to the print spooler. Unidrv specifies the font type and the IPrintOemUni::TTDownloadMethod method should specify the printer's preferred format in the location pointed to by pdwResult.

The method should not return TTDOWNLOAD_TTOUTLINE unless the printer can rasterize TrueType fonts. The rendering plug-in is responsible for reading and parsing TrueType font files. Pointers to TrueType font files can be obtained by calling FONTOBJ_pvTrueTypeFontFile.

The IPrintOemUni::TTDownloadMethod 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 "TTDownLoadMethod" as input.

For additional information see Customized Font Management.

Requirements

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