IPrintOemUni::TTDownloadMethod method (prcomoem.h)
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 |
|---|---|
|
The operation succeeded. |
|
The operation failed. |
|
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) |