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.
A version of this page is also available for
4/8/2010

This method retrieves device-specific information about a remote Windows Embedded CE–based device.

Syntax

int CeGetDesktopDeviceCaps(
  int 
nIndex 
);

Parameters

nIndex

[in] Specifies the item to return. It is one of the following values.

Value Description

DRIVERVERSION

Returns the device driver version.

TECHNOLOGY

Returns the device technology (DT). It is one of the following values:

DT_PLOTTER (Vector plotter)

DT_RASDISPLAY (Raster display)

DT_RASPRINTER (Raster printer)

DT_RASCAMERA (Raster camera)

DT_CHARSTREAM (Character stream)

DT_METAFILE (Metafile)

DT_DISPFILE (Display file)

If the hdcparameter identifies the device context of an enhanced metafile, the device technology is that of the referenced device as given to the CreateEnhMetaFilefunction. To determine whether it is an enhanced metafile device context, use the GetObjectTypefunction.

HORZSIZE

Returns the width, in millimeters, of the physical screen.

VERTSIZE

Returns the height, in millimeters, of the physical screen.

HORZRES

Returns the width, in pixels, of the screen.

VERTRES

Return the height, in raster lines, of the screen.

BITSPIXEL

Returns the number of adjacent color bits for each pixel.

PLANES

Returns the number of color planes.

NUMBRUSHES

Returns the number of device-specific brushes.

NUMPENS

Returns the number of device-specific pens.

NUMMARKERS

Returns the number of device-specific markers.

NUMFONTS

Returns the number of device-specific fonts.

NUMCOLORS

Returns the number of entries in the device's color table, if the device has a color depth of no more than 8 bits per pixel. For devices with greater color depths, –1 is returned.

ASPECTX

Returns the relative width of a device pixel used for line drawing.

ASPECTY

Returns the relative height of a device pixel used for line drawing.

ASPECTXY

Returns the diagonal width of the device pixel used for line drawing.

PDEVICESIZE

Reserved.

CLIPCAPS

Returns the flag that indicates the clipping capabilities of the device. If the device can clip to a rectangle, it is 1. Otherwise, it is 0.

PHYSICALWIDTH

For printing devices, returns the width of the physical page, in device units. For example, a printer set to print at 600 dpi on 8.5"x11" paper has a physical width value of 5100 device units. Note that the physical page is almost always greater than the printable area of the page, and never smaller.

PHYSICALHEIGHT

For printing devices, returns the height of the physical page, in device units. For example, a printer set to print at 600 dpi on 8.5"x11" paper has a physical height value of 6600 device units. Note that the physical page is almost always greater than the printable area of the page, and never smaller.

PHYSICALOFFSETX

For printing devices, returns the distance from the left edge of the physical page to the left edge of the printable area, in device units. For example, a printer set to print at 600 dpi on 8.5"x11" paper, that cannot print on the leftmost 0.25" of paper, has a horizontal physical offset of 150 device units.

PHYSICALOFFSETY

For printing devices, returns the distance from the top edge of the physical page to the top edge of the printable area, in device units. For example, a printer set to print at 600 dpi on 8.5"x11" paper, that cannot print on the topmost 0.5" of paper, has a vertical physical offset of 300 device units.

RASTERCAPS

Returns the value that indicates the raster capabilities of the device, as shown in the following list:

RC_BANDING (Requires banding support)

RC_BITBLT (Capable of transferring bitmaps)

RC_BITMAP64 (Capable of supporting bitmaps larger than 64K)

RC_DI_BITMAP (Capable of supporting the SetDIBitsand GetDIBitsfunctions)

RC_DIBTODEV (Capable of supporting the SetDIBitsToDevicefunction)

RC_FLOODFILL (Capable of performing flood fills)

RC_GDI20_OUTPUT (Capable of supporting features of 16-bit Windows 2.0)

RC_PALETTE (Specifies a palette-based device)

RC_SCALING (Capable of scaling)

RC_STRETCHBLT (Capable of performing the StretchBltfunction)

RC_STRETCHDIB (Capable of performing the StretchDIBitsfunction)

CURVECAPS

Returns the value that indicates the curve capabilities of the device, as shown in the following list:

CC_NONE (Device does not support curves)

CC_CHORD (Device can draw chord arcs)

CC_CIRCLES (Device can draw circles)

CC_ELLIPSES (Device can draw ellipses)

CC_INTERIORS (Device can draw interiors)

CC_PIE (Device can draw pie wedges)

CC_ROUNDRECT (Device can draw rounded rectangles)

CC_STYLED (Device can draw styled borders)

CC_WIDE (Device can draw wide borders)

CC_WIDESTYLED (Device can draw borders that are wide and styled)

LINECAPS

Returns the value that indicates the line capabilities of the device, as shown in the following list:

LC_NONE (Device does not support lines)

LC_INTERIORS (Device can draw interiors)

LC_MARKER (Device can draw a marker)

LC_POLYLINE (Device can draw a polyline)

LC_POLYMARKER (Device can draw multiple markers)

LC_STYLED (Device can draw styled lines)

LC_WIDE (Device can draw wide lines)

LC_WIDESTYLED (Device can draw lines that are wide and styled)

POLYGONALCAPS

Returns the value that indicates the polygon capabilities of the device, as shown in the following list:

PC_NONE (Device does not support polygons)

PC_INTERIORS (Device can draw interiors)

PC_POLYGON (Device can draw alternate-fill polygons)

PC_RECTANGLE (Device can draw rectangles)

PC_SCANLINE (Device can draw a single scanline)

PC_STYLED (Device can draw styled borders)

PC_WIDE (Device can draw wide borders)

PC_WIDESTYLED (Device can draw borders that are wide and styled)

PC_WINDPOLYGON (Device can draw winding-fill polygons)

TEXTCAPS

Returns the value that indicates the text capabilities of the device, as shown in the following list:

TC_OP_CHARACTER (Device is capable of character output precision)

TC_OP_STROKE (Device is capable of stroke output precision)

TC_CP_STROKE (Device is capable of stroke clip precision)

TC_CR_90 (Device is capable of 90-degree character rotation)

TC_CR_ANY (Device is capable of any character rotation)

TC_SF_X_YINDEP (Device can scale independently in the x- and y-directions)

TC_SA_DOUBLE (Device is capable of doubled character for scaling)

TC_SA_INTEGER (Device uses integer multiples only for character scaling)

TC_SA_CONTIN (Device uses any multiples for exact character scaling)

TC_EA_DOUBLE (Device can draw double-weight characters)

TC_IA_ABLE (Device can italicize)

TC_UA_ABLE (Device can underline)

TC_SO_ABLE (Device can draw strikeouts)

TC_RA_ABLE (Device can draw raster fonts)

TC_VA_ABLE (Device can draw vector fonts)

TC_RESERVED (Reserved; must be zero)

TC_SCROLLBLT (Device cannot scroll using a bit-block transfer. Note that this meaning may be the opposite of what you expect)

Return Value

The return value is the value of the specified item.

Requirements

Header rapi2.h
Library ole32.lib, rapiuuid.lib
Windows Embedded CE Windows Embedded CE 6.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

IRAPISession