Microsoft Windows CE 3.0  

DDSCAPSEX

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.

The DDSCAPSEXstructure contains the extended surface capabilities as defined by the application. This structure can be used as a comparison against the DDSCAPS2structure that is set by the driver.

typedef struct _DDSCAPSEX
{
DWORD
dwCaps2
;
DWORD
dwCaps3
;
DWORD
dwCaps4
;
} DDSCAPSEX, FAR * LPDDSCAPSEX;

Members

dwCaps2
Additional surface capabilities. This member can contain one or more of the following capability flags. Each of these flags, except DDSCAPS2_TEXTUREMANAGE, are set by the application when the application calls its CreateSurface method. One or more of the following:
Flag Usage
DDSCAPS2_HARDWAREDEINTERLACE Indicates that the driver must do whatever is necessary to match the video port frame rate with the device frame rate. The DDSCAPS_VIDEOPORT and DDSCAPS_OVERLAY flags in the DDSCAPS2structure must also be set.
DDSCAPS2_HINTANTIALIASING Indicates that the application intends to use antialiasing. This flag is only valid if the DDSCAPS_3DDEVICE flag is also set.
DDSCAPS2_HINTDYNAMIC Indicates to the driver that the application will be updating the surface frequently. Surfaces with this flag set must also have the DDSCAPS_TEXTURE flag in the DDSCAPS2structure set. This flag cannot be used with the DDSCAPS2_HINTSTATIC or DDSCAPS2_OPAQUE flags.
DDSCAPS2_HINTSTATIC Indicates to the driver that the application will be updating the surface infrequently, but still requires access. Surfaces with this flag set must also have the DDSCAPS_TEXTURE flag in the DDSCAPS2structure set. This flag cannot be used with the DDSCAPS2_HINTDYNAMIC or DDSCAPS2_OPAQUE flags.
DDSCAPS2_OPAQUE Indicates to the driver that the application will never lock, blit, or update the surface for the rest of that surface's lifetime. The driver is therefore free to compress or reorder the surface without ever having to decompress it. Surfaces with this flag set must also have the DDSCAPS_TEXTURE flag in the DDSCAPS2structure set. This flag cannot be used with the DDSCAPS2_HINTDYNAMIC or DDSCAPS2_HINTSTATIC flags.
DDSCAPS2_TEXTUREMANAGE This flag is used by DirectDraw and should not be set by the driver.
dwCaps3and dwCaps4
Not currently used.

Requirements

Runs on Versions Declared in
Windows CE OS 2.12 or later. Version 2.12 requires DXPAK 1.0 or later. ddraw.h