Hardware Dev Center

IPrintOemUni::TTDownloadMethod method

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

Parameters

pdevobj

Caller-supplied pointer to a DEVOBJ structure.

pUFObj

Caller-supplied pointer to a UNIFONTOBJ structure.

pdwResult [out]

Receives one of the following method-supplied constant values:

ValueDefinition

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

Target platform

Desktop

Header

Prcomoem.h (include Prcomoem.h)

See also

DEVOBJ
UNIFONTOBJ
FONTOBJ_pvTrueTypeFontFile
IPrintOemUni::GetImplementedMethod

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft