 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This section shows the definition of the GPEModeExstructure. It then describes the meaning of each field, and gives you information about how you can use it in your driver.
#define GPEMODEEX_VERSION0(0) #define
GPEMODEEX_CURRENTVERSION(GPEMODEEX_VERSION0) struct GPEModeEx { //
old-style mode info GPEMode modeInfo; // for expansion
DDGPEStandardHeader; // pixel format of mode EDDGPEPixelFormat
ePixelFormat; // pixel FourCC code DWORD dwPixelFourCC // any user
data associated with pixel format DWORD dwPixelFormatData; // pitch
(in bytes) LONG lPitch; // flags DWORD dwFlags; // red bit mask
DWORD dwRBitMask; // green bit mask DWORD dwGBitMask; // blue bit
mask DWORD dwBBitMask; // alpha bit mask DWORD dwAlphaBitMask;
};
modeInfo
The modeInfo field of GPEModeExcontains 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 DDGPEStandardHeaderfor more information.
ePixelFormat
This field identifies the surface's EDDGPEPixelFormat. See EDDGPEPixelFormatfor 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
The lPitch field identifies the pitch of the specified mode.
dwFlags
The dwFlags field contains flags for the current surface. This field should be set to zero (0).
dwRBitMask
This field indicates the red bit mask for surfaces in the current mode.
dwGBitMask
This field indicates the green bit mask for surfaces in the current mode.
dwBBitMask
This field indicates the blue bit mask for surfaces in the current mode.
dwAlphaBitMask
This field indicates the alpha bit mask for surfaces in the current mode.
Last updated on Tuesday, July 13, 2004