Share via

GDIINFO (Windows CE 5.0)

  • Article

Send Feedback

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.

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

OS Versions: Windows CE 2.12 and later.
Header: Wingdi.h.

See Also

Display Drivers

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.