GET_PS_FEATURESETTING Printer Escape function

Article
06/01/2017

The GET_PS_FEATURESETTING printer escape function retrieves information about a specified feature setting for a PostScript driver.

This escape function is supported only if the PostScript driver is in PostScript-centric mode or in GDI-centric mode. To set the PostScript driver mode, call the POSTSCRIPT_IDENTIFY escape function.

To perform this operation, call the ExtEscape function with the following parameters.

Syntax

int ExtEscape(
  _In_  HDC    hdc,
  _In_  int    nEscape,
  _In_  int    cbInput,
  _In_  LPCSTR lpszInData,
  _In_  int    cbOutput,
  _Out_ LPSTR  lpszOutData
);

Parameters

hdc [in]
A handle to the printer device context.
nEscape [in]
The escape function to be performed.

Value Meaning

GET_PS_FEATURESETTING
Gets information on a specified feature setting for a PostScript driver.
cbInput [in]
The number of bytes of data pointed to by the lpszInData parameter.

For this escape, set this value to sizeof ( INT ).

Value	Meaning
GET_PS_FEATURESETTING	Gets information on a specified feature setting for a PostScript driver.

lpszInData [in]
A pointer to the INT variable that contains a feature setting value from the following table.

Windows XP and later versions of Windows support the private use of this parameter. For private use, you can use the numbers in the range from FEATURESETTING_PRIVATE_BEGIN to FEATURESETTING_PRIVATE_END. Private parties that intend to use numbers in this range should contact Microsoft first to avoid conflicts with other applications.

Value	Meaning
FEATURESETTING_CUSTPAPER	Retrieves the custom paper parameters. Set cbOutput to `sizeof ( PSFEATURE_CUSTPAPER )` and lpszOutData to point to a PSFEATURE_CUSTPAPER structure.
FEATURESETTING_MIRROR	Retrieves the mirrored output setting. Set cbOutput to `sizeof ( BOOL )` and lpszOutData to point to a BOOL variable. If mirrored output is selected, the value returned in lpszOutData is TRUE. If mirrored output is not selected, the value returned in lpszOutData is FALSE
FEATURESETTING_NEGATIVE	Retrieves the negative output setting. Set cbOutput to `sizeof ( BOOL )` and lpszOutData to point to a BOOL variable. When the function returns, the lpszOutData variable is TRUE if "Negative Output: Yes" is selected; otherwise, it is FALSE.
FEATURESETTING_NUP	Retrieves the N-Up setting of the page layout. Set cbOutput to `sizeof ( BOOL )` and lpszOutData to point to a BOOL variable. If an N-Up page layout is not being used, the lpszOutData variable returns FALSE. If an N-Up page layout is being used, the lpszOutData variable returns TRUE. However, the variable does not indicate the format of the N-Up page layout or its semantics.
FEATURESETTING_OUTPUT	Retrieves information about PostScript driver output options. Set cbOutput to `sizeof ( PSFEATURE_OUTPUT )` and lpszOutData to point to a PSFEATURE_OUTPUT structure.
FEATURESETTING_PROTOCOL	Retrieves the output protocol setting. Sets cbOutput to `sizeof( INT )` and lpszOutData to point to an INT variable. When the function returns, the lpszOutData variable is set to one of the following output protocol values: PSPROTOCOL_ASCII PSPROTOCOL_BCP PSPROTOCOL_TBCP PSPROTOCOL_BINARY
FEATURESETTING_PSLEVEL	Retrieves the PostScript language level. Set cbOutput to `sizeof ( INT )` and lpszOutData to point to an INT variable. When the function returns, the lpszOutData variable is set to 1, 2, 3, or higher to indicate the PostScript language level.

cbOutput [in]
The number of bytes of data pointed to by the lpszOutData parameter.
lpszOutData [out]
A pointer to the structure that receives output from this escape. This parameter must not be NULL if ExtEscape is called as a query function. If no data is to be returned in this structure, set cbOutput to 0.

Return value

The return value is greater than zero if the function is successful and less than zero if not. A return value of zero indicates that the printer does not support this escape.

Remarks

The GET_PS_FEATURESETTING printer escape function is valid if called any time after calling the CreateDC function and before calling the DeleteDC function.

Requirements

Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Wingdi.h (include Windows.h)

Partager via