ExtEscape

  int ExtEscape(hdc, nEscape, cbInput, lpszInData, cbOutput, lpszOutData)    
  HDC hdc; /* handle of device context */
  int nEscape; /* specifies escape function */
  int cbInput; /* size of structure for input */
  LPCSTR lpszInData; /* address of structure for input */
  int cbOutput; /* size of output data */
  LPSTR lpszOutData; /* address of structure for output */

The ExtEscape function allows applications to access capabilities of a particular device that are not directly available through the graphics device interface (GDI). Escape calls made by an application are translated and sent to the driver.

Use this function to pass an application-defined escape value to a driver. Use the Escape function to pass one of the predefined escape values to a driver.

Parameters

hdc

Identifies the device context.

nEscape

Specifies the application-defined escape function to be performed.

cbInput

Specifies the number of bytes of data pointed to by the lpszInData parameter.

lpszInData

Points to the input structure required for the specified escape.

cbOutput

Specifies the number of bytes of data pointed to by the lpszOutData parameter.

lpszOutData

Points to the structure that receives output from this escape. This parameter should be NULL if no data is returned.

Return Value

The return value specifies the outcome of the function. It is greater than zero if the function is successful, except for the QUERYESCSUPPORT printer escape, which checks for implementation only. The return value is zero if the escape is not implemented. A return value less than zero indicates an error. Use the GetLastError function to obtain extended error information.

See Also

Escape