Microsoft KB Archive/74606

From BetaArchive Wiki

Documentation for the DOWNLOADFACE Printer Escape

Q74606



The information in this article applies to:


  • Microsoft Windows Device Development Kit (DDK) for Windows, versions 3.0, 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.

GETVERSION

This escape was intended to return the version number of the driver. Considering that the PostScript driver still returns 100, it probably is not very useful. Besides, we want people to avoid driver dependency whenever possible. Aldus added it for PageMaker versions starting at 3.1.

SETDIBSCALING

This was done before the StretchDIB function was created. We do not want people to use this, so please do not document it. It provides no additional support beyond StretchDIB.

Additional query words: 3.00 3.10 docerr DDKPRINT

Keywords :
Issue type :
Technology :


Last Reviewed: November 1, 1999
© 2001 Microsoft Corporation. All rights reserved. Terms of Use.