Documentation for the DOWNLOADFACE Printer Escape

Last reviewed: February 16, 1995
Article ID: Q74606
The information in this article applies to:
  • Microsoft Windows Device Driver Kit (DDK) for Windows versions 3.0 and 3.1

SUMMARY

The DOWNLOADFACE printer escape is not documented in versions 3.0 or 3.1 of the Microsoft Windows Software Development Kit (SDK) or of the Microsoft Windows Device Development Kit (DDK). The text below provides documentation for this particular printer escape.

MORE INFORMATION

Add the following line to WINDOWS.H header file to define the DOWNLOADFACE escape:

   #define DOWNLOADFACE    514

The following documentation for the DOWNLOADFACE escape is in the same format used in the Windows SDK documentation.

   short Escape(hDC, DOWNLOADFACE, NULL, lpInData, lpOutData)

The escape is used to determine if a font is a downloadable font (soft font or TrueType) or to force the font definition to be downloaded to the printer.

Parameter      Type/Description
---------      ----------------

hDC            HDC Identifies the device context.

lpInData       EXTTEXTMETRIC FAR * Points to a structure returned from
               the GETEXTENDEDTEXTMETRICS escape.

lpOutData      SHORT FAR * Points to a value indicating one of two
               actions:
               0 means to inquire the font type
               1 means to force the download

Return Value

This escape returns -1 if the font is not downloadable and 1 if it is downloadable. The escape also returns a 1 if the font was successfully downloaded to the printer and -1 if the download failed.


Additional reference words: 3.00 3.10 docerr DDKPRINT
KBCategory: kbprg kbdocerr
KBSubcategory: GdiPrnMis


THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: February 16, 1995
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.