Microsoft Windows CE 3.0  

ExtEscape

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

The ExtEscapefunction allows applications to communicate directly with display device drivers. This function has the same definition in Windows CE as on Win32-based platforms.

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

Parameters

hdc
A handle to a device context.
nEscape
The escape code.
cbInput
The number of bytes of input data.
lpszInData
A pointer to the input data.
cbOutput
The number of bytes of output data.
lpszOutData
A pointer to the output data.

Remarks

This function passes its arguments to a display driver's DrvEscapefunction, allowing applications to request actions by a display driver that have no corresponding expression in terms of GDI calls. Windows CE currently defines the following unique escape codes for use with ExtEscape:

Escape Code Meaning
GETVFRAMEPHYSICAL Returns the physical address of the video frame buffer.
GETVFRAMELEN Returns the length of the video frame buffer.
DBGDRIVERSTAT Returns driver statistics.
SETPOWERMANAGEMENT Sets the power management mode, for drivers or display hardware that support suspend/auto-shutoff modes.
GETPOWERMANAGEMENT Returns the current power management mode.

In general, only OEMs should make use of these escape codes. IHVs do not typically need them. Support for these codes in the sample video drivers varies; the sample drivers do not all implement these codes, and some drivers only implement some of these codes.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 2.10 and later      


 Last updated on Tuesday, July 13, 2004

© 2004 Microsoft Corporation. All rights reserved.