GDIINFO

Other versions of this page are also available for the following:

Windows Mobile Not SupportedWindows Embedded CE Supported

8/28/2008

This structure contains information about the graphics device supported by a device driver. GDI retrieves this structure when it loads the driver and uses the information in the structure to initialize the driver.

Syntax

typedef struct tagGDIINFO {
  ULONG ulVersion;
  ULONG ulTechnology;
  ULONG ulHorzSize;
  ULONG ulVertSize;
  ULONG ulHorzRes;
  ULONG ulVertRes;
  ULONG cBitsPixel;
  ULONG cPlanes;
  ULONG ulNumBrushes;
  ULONG flRaster;
  ULONG ulLogPixelsX;
  ULONG ulLogPixelsY;
  ULONG flTextCaps;
  ULONG ulDACRed;
  ULONG ulDACGreen;
  ULONG ulDACBlue;
  ULONG ulAspectX;
  ULONG ulAspectY;
  ULONG ulAspectXY;
  LONG xStyleStep;
  LONG yStyleStep;
  LONG denStyleStep;
  POINTL ptlPhysOffset;
  SIZEL szlPhysSize;
  ULONG ulNumPalReg;
  ULONG ulDevicePelsDPI;
  ULONG ulPrimaryOrder;
  ULONG ulHTPatternSize;
  ULONG ulHTOutputFormat;
  ULONG flHTFlags;
  ULONG ulVRefresh;
  ULONG ulBltAlignment;
  ULONG ulPanningHorzRes;
  ULONG ulPanningVertRes;
} GDIINFO;

Members

  • ulVersion
    Version number. The high-order byte specifies the major version, the low-order byte the minor version.
  • ulTechnology
    Device technology. The following table shows the possible values. Set to one of these values.

    Value Description

    DT_PLOTTER

    Vector plotter.

    DT_RASDISPLAY

    Raster display.

    DT_RASPRINTER

    Raster printer.

    All other values are reserved.

  • ulHorzSize
    Width, in millimeters, of the physical display surface.
  • ulVertSize
    Height, in millimeters, of the physical display surface.
  • ulHorzRes
    Width, in pixels, of the display surface. For nonraster devices, this width is equivalent to the number of vertical grid lines used by the device to plot points on the display surface. In such cases, a pixel is defined to be the smallest mark the device can draw.
  • ulVertRes
    Height, in raster lines, of the display. For nonraster devices, this height is equivalent to the number of horizontal grid lines used by the device to plot points on the display surface. In such cases, a raster line is equivalent to a gridline.
  • cBitsPixel
    Number of adjacent bits on each plane required to define a single pixel.
  • cPlanes
    Number of planes required to define the pixels. This parameter is typically 1.
  • ulNumBrushes
    Number of device-specific brushes.
  • ulNumColors
    Number of entries in the color table for the device or the number of reserved colors for a palette-capable device.
  • flRaster
    Raster capabilities. The following table shows the possible values. Set to a combination of these values.

    Value Description

    RC_NONE

    No raster capabilities.

    RC_BITBLT

    Can transfer bitmaps. The driver exports the BitBlt function.

    RC_BANDING

    Requires banding support.

    RC_SCALING

    Requires scaling support.

    RC_SAVEBITMAP

    Saves bitmaps locally in shadow memory. The driver exports the SaveScreenBitmap function.

    RC_PALETTE

    Performs color-palette management.

    RC_DIBTODEV

    Transfers device-independent bitmaps (DIBs) directly to device. The driver exports the SetDIBitsToDevice function.

    RC_BIGFONT

    Displays large fonts.

    RC_STRETCHBLT

    Stretches and compresses bitmaps while transferring the bitmap. The driver exports the StretchBlt function.

    RC_FLOODFILL

    Perform flood filling. The driver exports the FloodFill function.

    RC_STRETCHDIB

    Stretches and compresses device-independent bitmaps while transferring the bitmap. The driver exports the StretchDIBits function.

    RC_DEVBITS

    Supports device bitmaps. Driver exports the BitmapBits and SelectBitmap function.

  • ulLogPixelsX
    Number of pixels per logical inch along a horizontal line on the display surface. This value is used to match fonts.
  • ulLogPixelsY
    Number of pixels per logical inch along a vertical line on the display surface. This value is used to match fonts.
  • flTextCaps
    Flag. The following table shows the possible values. They can be combined.

    Value Description

    Zero (0)

    Driver does not support anti-aliased or Microsoft® ClearType® display technology text.

    GCAPS_GRAY16

    Driver supports anti-aliased text.

    GCAPS_CLEARTYPE

    Driver supports ClearType text.

  • ulDACRed
    Ignored, set to NULL.
  • ulDACGreen
    Ignored, set to NULL.
  • ulDACBlue
    Ignored, set to NULL.
  • ulAspectX
    Relative width of a device pixel. This value, in the range 1 through 1000, provides information about device's aspect ratio.
  • ulAspectY
    Relative height of a device pixel. This value, in the range 1 through 1000, provides information about device's aspect ratio.
  • ulAspectXY
    Relative diagonal width of a device pixel. This value, in the range 1 through 1000, provides information about device's aspect ratio. It must be equal to the square root of the sum of the squares of ulAspectX and ulAspectY.
  • xStyleStep
    Ignored, set to NULL.
  • yStyleStep
    Ignored, set to NULL.
  • denStyleStep
    Ignored, set to NULL.
  • ptlPhysOffset
    Number of device units between the top-left corner of the physical page and the top-left corner of the printable area of the page. Use for printing devices.
  • szlPhysSize
    Width and height of the high-resolution metric window. The width is ulHorzSize*100; the height is ulVertSize*100.
  • ulNumPalReg
    Ignored, set to NULL.
  • ulDevicePelsDPI
    Ignored, set to NULL.
  • ulPrimaryOrder
    Ignored, set to NULL.
  • ulHTPatternSize
    Ignored, set to NULL.
  • ulHTOutputFormat
    Ignored, set to NULL.
  • flHTFlags
    Ignored, set to NULL.
  • ulVRefresh
    Refresh rate of the display device in hertz.
  • ulBltAlignment
    Ignored, set to NULL.
  • ulPanningHorzRes
    Ignored, set to NULL.
  • ulPanningVertRes
    Ignored, set to NULL.

Requirements

Header wingdi.h
Windows Embedded CE Windows CE 2.12 and later

See Also

Other Resources

Display Drivers