ExtEscape

This function allows applications to access capabilities of a particular device that are not available through the graphics display interface (GDI). The device capabilities that this function accesses must be implemented by an OEM.

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

Parameters

  • hdc
    [in] Handle to the device context.
  • nEscape
    [in] Specifies the escape function to be performed.
  • cbInput
    [in] Specifies the number of bytes of data pointed to by the lpszInData parameter.
  • lpszInData
    [in] Long pointer to the input structure required for the specified escape.
  • cbOutput
    [in] Specifies the number of bytes of data pointed to by the lpszOutData parameter.
  • lpszOutData
    [out] Long 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 Values

A value greater than zero indicates success. A value less than zero indicates an error. The QUERYESCSUPPORT printer escape, which checks for implementation only, returns zero when the escape is not implemented.

To get extended error information, call GetLastError.

Remarks

Use this function to pass a driver-defined escape value to a device.

The escape values passed in to this function are driver-defined. Windows CE does not support any system-defined escape values.

When using QUERYESCSUPPORT to find out whether a device supports an escape value, set the nEscape parameter to QUERYESCSUPPORT and point to the escape value in question with the lpszInData parameter.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 2.10 and later Wingdi.h   Mgdc.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

GetDeviceCaps, GetLastError

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.