8月7日

GPEModeEx 

This structure contains mode information.

Syntax

#define GPEMODEEX_VERSION0(0)
#define GPEMODEEX_CURRENTVERSION(GPEMODEEX_VERSION0)
  struct GPEModeEx {
  GPEMode modeInfo; 
  DDGPEStandardHeader; 
  EDDGPEPixelFormat ePixelFormat; 
  DWORD dwPixelFourCC; 
  DWORD dwPixelFormatData; 
  LONG lPitch; 
  DWORD dwFlags; 
  DWORD dwRBitMask; 
  DWORD dwGBitMask; 
  DWORD dwBBitMask; 
  DWORD dwAlphaBitMask 
};

Members

modeInfo

Contains the GPEMode for the current device. You can use this field instead of having a separate GPEMode member variable in your device driver.

DDGPEStandardHeader

See DDGPEStandardHeader for more information.

ePixelFormat

Identifies the surface's EDDGPEPixelFormat. See EDDGPEPixelFormat for more information.

dwPixelFourCC

The value of dwPixelFourCC can be used to indicate the FourCC code for the current surface. This value should be zero (0), if the FourCC information does not apply.

dwPixelFormatData

Drivers can use the dwPixelFormatData element, if it is necessary to store more detailed information about a particular mode or its surface type. The value of this field is 

ignored by DDGPE.

lPitch

Identifies the pitch of the specified mode.

dwFlags

Flags for the current surface. This field should be set to zero (0).

dwRBitMask

Indicates the red bit mask for surfaces in the current mode.

dwGBitMask

Indicates the green bit mask for surfaces in the current mode.

dwBBitMask

Indicates the blue bit mask for surfaces in the current mode.

dwAlphaBitMask

Indicates the alpha bit mask for surfaces in the current mode.

m_pModeEx 

The m_pModeEx member variable should be initialized by your driver to contain a pointer to GDI's current mode information. Like GPE's m_pMode, you should update it whenever the GDI mode changes.

Syntax 

GPEModeEx* m_pModeEx;

GPEMode

This structure contains information on the width, height, bits per pixel (bpp), frequency, and format.

Syntax

struct GPEMode {
  int modeId;
  int width;
  int height;
  int Bpp;
  int frequency;
  EGPEFormat format;
};

Members

modeId

Number determined by the developer. Each video mode, resolution, bit-depth, and vertical retrace frequency, has a number determined by the driver developer.

width

Width of primary surface, or screen, in pixels. For example, 640.

height

Height of primary surface, or screen, in pixels. For example, 480.

Bpp

Bpp, number of bits that represent each pixel on a screen. For example 16 bpp is 2 to 16th power, which is 65,536 possible unique colors per pixel.

frequency

Monitor frequency, the vertical retrace frequency. Which is the number of whole screen scans of the cathode ray tube gun per second.

format

RGB representation. Specifies how the bits in a pixel represent RGB, such as how many bits are used for red, green, or blue, or a palletized value where the pixel value is

 an offset into a palette.