Using GetGlobalAttribute

Important

We recommend that you use Microsoft's IPP inbox class driver, along with Print Support Apps (PSA), to customize the print experience in Windows 10 and 11 for printer device development.

For more information, see the Print support app design guide.

All of the global attribute names are the same as the keyword names defined in PostScript Printer Description File Format Specification, v4.3. Refer to this specification for their semantics. (This resource may not be available in some languages and countries.)

In the following table, the pdwDataType parameter takes values of the EATTRIBUTE_DATATYPE enumerated type.

Global attribute Output parameters
CenterRegistered pdwDataType: kADT_BOOL

pbData: TRUE or FALSE

pcbNeeded: sizeof(BOOL)
ColorDevice pdwDataType: kADT_BOOL

pbData: TRUE or FALSE

pcbNeeded: sizeof(BOOL)
Extensions pdwDataType: kADT_ASCII

pbData: ASCII string (in MULTI_SZ format) containing registered values of extensionOption the printer supports.

pcbNeeded: byte count of the ASCII string pointed to by pbData (including the last null character).

"FileSystem: True" is treated as if Extensions had the "FileSystem" option. "FileSystem: False" is treated as if Extensions didn't have the "FileSystem" option.
FileVersion pdwDataType: kADT_DWORD

pbData: a DWORD whose high-order word contains the major version number, and whose low-order word contains the minor version number.

pcbNeeded: sizeof(DWORD)
FreeVM pdwDataType: kADT_DWORD

pbData: value of FreeVM

pcbNeeded: sizeof(DWORD)
LandscapeOrientation pdwDataType: kADT_ASCII

pbData: NULL-terminated ASCII string of either "Plus90" or "Minus90".

pcbNeeded: byte count of the ASCII string pointed to by pbData (including the last null character).

"Minus90" is returned only when the PPD contains "LandscapeOrientation: Minus90". In all other cases, "Plus90" is returned.
LanguageEncoding pdwDataType: kADT_ASCII

pbData: NULL-terminated ASCII string containing one of the following encodingOption values:

"ISOLatin1"

"Unicode"

"JIS83-RKSJ"

"None"

pcbNeeded: byte count of the ASCII string pointed to by pbData (including the last null character).

"WindowsANSI" is treated the same as "ISOLatin1". Other encodingOption values aren't supported.

If LanguageEncoding is absent, LanguageVersion is used to deduce the return value.
LanguageLevel pdwDataType: kADT_DWORD

pbData: PostScript language level supported by the printer

pcbNeeded: sizeof(DWORD)
NickName pdwDataType: kADT_UNICODE

pbData: NULL-terminated Unicode string of the PPD's ShortNickName value if ShortNickName is present, or NickName value if ShortNickName is absent.

pcbNeeded: byte count of the Unicode string pointed to by pbData (including the last null character)
PPD-Adobe pdwDataType: kADT_DWORD

pbData: a DWORD whose high-order word contains the major version number, and whose low-order word contains the minor version number.

pcbNeeded: sizeof(DWORD)
PrintPSErrors pdwDataType: kADT_BOOL

pbData: TRUE or FALSE

pcbNeeded: sizeof(BOOL)

If PrintPSErrors is absent, it's assumed to be TRUE.
Product pdwDataType: kADT_BINARY

pbData: the Product value

pcbNeeded: byte count of output binary data

Only the first Product entry is returned.
Protocols pdwDataType: kADT_ASCII

pbData: ASCII string (in MULTI_SZ format) containing registered values of protocolOption the printer supports.

pcbNeeded: byte count of the ASCII string pointed to by pbData (including the last null character)
PSVersion pdwDataType: kADT_BINARY

pbData: the PSVersion value

pcbNeeded: byte count of output binary data

Only the first PSVersion entry is returned.
SuggestedJobTimeout pdwDataType: kADT_DWORD

pbData: the SuggestedJobTimeout value. If it's absent from the PPD, returns 0 by default.

pcbNeeded: sizeof(DWORD)
SuggestedWaitTimeout pdwDataType: kADT_DWORD

pbData: the SuggestedWaitTimeout value. If it isn't present in the PPD, returns 300 by default.

pcbNeeded: sizeof(DWORD)
Throughput pdwDataType: kADT_DWORD

pbData: the Throughput value. If it isn't present in the PPD, returns 0 by default.

pcbNeeded: sizeof(DWORD)
TTRasterizer pdwDataType: kADT_ASCII

pbData: a NULL-terminated ASCII string containing one of following rasterizerOption values:

"None"

"Accept68K"

"Type42"

"TrueImage"

pcbNeeded: byte count of the ASCII string pointed to by pbData (including the last null character).

If the*TTRasterizer entry is absent, "None" is returned.