Share via


GetDeviceCaps (Compact 2013)

3/28/2014

This function retrieves information about the capabilities of a specified device.

Syntax

int GetDeviceCaps(
  HDC hdc, 
  int nIndex
);

Parameters

  • hdc
    [in] Handle to the device context.
  • nIndex
    [in] Specifies the item to return.

    This parameter can be one of the following values.

    Value

    Description

    ASPECTX

    Relative width of a device pixel used for line drawing.

    ASPECTXY

    Diagonal width of the device pixel used for line drawing.

    ASPECTY

    Relative height of a device pixel used for line drawing.

    BITSPIXEL

    Number of adjacent color bits for each pixel.

    CLIPCAPS

    Flag that indicates the clipping capabilities of the device.

    If the device can clip to a rectangle, it is 1. Otherwise, it is 0.

    COLORRES

    Actual color resolution of the device, in bits per pixel.

    This index is valid only if the device driver sets the RC_PALETTE bit in the RASTERCAPS index and is available only if the driver is compatible with 16-bit Windows.

    CURVECAPS

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

     

    CC_CHORD

     

    CC_CIRCLES

     

    CC_ELLIPSES

     

    CC_INTERIORS

     

    CC_NONE

     

    CC_PIE

     

    CC_ROUNDRECT

     

    CC_STYLED

     

    CC_WIDE

     

    CC_WIDESTYLED

    DRIVERVERSION

    The device driver version.

    HORZRES

    Width, in pixels, of the screen.

    HORZSIZE

    Width, in millimeters, of the physical screen.

    LINECAPS

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

     

    LC_INTERIORS

     

    LC_MARKER

     

    LC_NONE

     

    LC_POLYLINE

     

    LC_POLYMARKER

     

    LC_STYLED

     

    LC_WIDE

     

    LC_WIDESTYLED

    LOGPIXELSX

    Number of pixels per logical inch along the screen width.

    In a system with multiple display monitors, this value is the same for all monitors.

    LOGPIXELSY

    Number of pixels per logical inch along the screen height.

    In a system with multiple display monitors, this value is the same for all monitors.

    NUMBRUSHES

    Number of device-specific brushes.

    NUMCOLORS

    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.

    NUMFONTS

    Number of device-specific fonts.

    NUMPENS

    Number of device-specific pens.

    NUMRESERVED

    Number of reserved entries in the system palette.

    This index is valid only if the device driver sets the RC_PALETTE bit in the RASTERCAPS index and is available only if the driver is compatible with 16-bit Windows.

    PDEVICESIZE

    Reserved.

    PHYSICALHEIGHT

    For printing devices: 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.

    The physical page is almost always greater than the printable area of the page, and never smaller.

    PHYSICALOFFSETX

    For printing devices: 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: 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.

    PHYSICALWIDTH

    For printing devices: 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.

    The physical page is almost always greater than the printable area of the page, and never smaller.

    PLANES

    Number of color planes.

    POLYGONALCAPS

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

     

    PC_INTERIORS

     

    PC_NONE

     

    PC_POLYGON

     

    PC_RECTANGLE

     

    PC_SCANLINE

     

    PC_STYLED

     

    PC_WIDE

     

    PC_WIDESTYLED

     

    PC_WINDPOLYGON

    RASTERCAPS

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

     

    RC_BANDING

     

    RC_BITBLT

     

    RC_BITMAP64

     

    RC_DI_BITMAP

     

    RC_DIBTODEV

     

    RC_GDI20_OUTPUT

     

    RC_PALETTE

     

    RC_SCALING

     

    RC_STRETCHBLT

     

    RC_STRETCHDIB

    SHADEBLENDCAPS

    Value that indicates the shading and blending capabilities of the device. See Remarks for further comments.

     

    SB_CONST_ALPHA

     

    SB_GRAD_RECT

     

    SB_GRAD_TRI

     

    0

     

    SB_PIXEL_ALPHA

     

    SB_PREMULT_ALPHA

    SIZEPALETTE

    Number of entries in the system palette.

    This index is valid only if the device driver sets the RC_PALETTE bit in the RASTERCAPS index and is available only if the driver is compatible with 16-bit Windows.

    TECHNOLOGY

    Device technology. It can be any one of the following values.

     

    DT_PLOTTER

     

    DT_RASDISPLAY

     

    DT_RASPRINTER

     

    DT_RASCAMERA

     

    DT_CHARSTREAM

     

    DT_DISPFILE

    TEXTCAPS

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

     

    TC_CP_STROKE

     

    TC_CR_90

     

    TC_CR_ANY

     

    TC_EA_DOUBLE

     

    TC_IA_ABLE

     

    TC_OP_CHARACTER

     

    TC_OP_STROKE

     

    TC_RA_ABLE

     

    TC_RESERVED

     

    TC_SA_CONTIN

     

    TC_SA_DOUBLE

     

    TC_SA_INTEGER

     

    TC_SCROLLBLT

     

    TC_SF_X_YINDEP

     

    TC_SO_ABLE

     

    TC_UA_ABLE

     

    TC_VA_ABLE

    TOUCHCAPS

    Type of touch hardware controller supported by the device.

    TC_NO_TOUCH

    TC_SINGLE_TOUCH

    TC_SYMMETRIC_TOUCH

    TC_MULTI_TOUCH

    VERTRES

    Height, in raster lines, of the screen.

    VERTSIZE

    Height, in millimeters, of the physical screen.

Return Value

Returns the value of the desired item.

Remarks

The following table shows the six indexes that GetDeviceCaps provides in place of printer escapes.

Index

Printer escape replaced

PHYSICALWIDTH

GETPHYSPAGESIZE

PHYSICALHEIGHT

GETPHYSPAGESIZE

PHYSICALOFFSETX

GETPRINTINGOFFSET

PHYSICALOFFSETY

GETPHYSICALOFFSET

Requirements

Header

windows.h

Library

coredll.lib

See Also

Reference

GDI Functions
GetObjectType
StretchBlt