GDIINFO (Windows Embedded CE 6.0)
1/6/2010
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 |