DDSURFACEDESC2-Struktur (ddraw.h)
Die DDSURFACEDESC2-Struktur enthält eine Beschreibung einer Vom Treiber zu erstellenden Oberfläche.
Syntax
typedef struct _DDSURFACEDESC2 {
DWORD dwSize;
DWORD dwFlags;
DWORD dwHeight;
DWORD dwWidth;
#if ...
union {
LONG lPitch;
DWORD dwLinearSize;
} DUMMYUNIONNAMEN;
#elif
union {
DWORD dwBackBufferCount;
DWORD dwDepth;
} DUMMYUNIONNAMEN;
#elif
union {
DWORD dwMipMapCount;
DWORD dwRefreshRate;
DWORD dwSrcVBHandle;
} DUMMYUNIONNAMEN;
DWORD dwAlphaBitDepth;
DWORD dwReserved;
LPVOID lpSurface;
#elif
union {
DDCOLORKEY ddckCKDestOverlay;
DWORD dwEmptyFaceColor;
} DUMMYUNIONNAMEN;
DDCOLORKEY ddckCKDestBlt;
DDCOLORKEY ddckCKSrcOverlay;
DDCOLORKEY ddckCKSrcBlt;
#else
union {
DDPIXELFORMAT ddpfPixelFormat;
DWORD dwFVF;
} DUMMYUNIONNAMEN;
#endif
DDSCAPS2 ddsCaps;
DWORD dwTextureStage;
} *LPDDSURFACEDESC2, DDSURFACEDESC2;
Member
dwSize
Gibt die Größe dieser DDSURFACEDESC2 Struktur in Bytes an. Dieses Element muss initialisiert werden, bevor die Struktur verwendet wird.
dwFlags
Gibt eine Reihe von Flags an, die bestimmen, welche Member der DDSURFACEDESC2-Struktur gültige Daten enthalten. Bei diesem Member kann es sich um mindestens eins der folgenden Flags handelt:
| Flag | Bedeutung |
|---|---|
DDSD_ALL |
Alle Eingabemember enthalten gültige Daten. |
DDSD_ALPHABITDEPTH |
Das dwAlphaBitDepth-Element ist gültig. |
DDSD_BACKBUFFERCOUNT |
Das dwBackBufferCount-Element ist gültig. |
DDSD_CAPS |
Das ddsCaps-Element ist gültig. |
DDSD_CKDESTBLT |
Das ddckCKDestBlt-Element ist gültig. |
DDSD_CKDESTOVERLAY |
Das ddckCKDestOverlay-Element ist gültig. |
DDSD_CKSRCBLT |
Das ddckCKSrcBlt-Element ist gültig. |
DDSD_CKSRCOVERLAY |
Das ddckCKSrcOverlay-Element ist gültig. |
DDSD_FVF |
Der dwFVF-Member ist gültig. |
DDSD_HEIGHT |
Das dwHeight-Element ist gültig. |
DDSD_LINEARSIZE |
Der dwLinearSize-Member ist gültig. |
DDSD_LPSURFACE |
Das lpSurface-Element ist gültig. |
DDSD_MIPMAPCOUNT |
Das dwMipMapCount-Element ist gültig. |
DDSD_PITCH |
Das lPitch-Element ist gültig. |
DDSD_PIXELFORMAT |
Das Element ddpfPixelFormat ist gültig. |
DDSD_REFRESHRATE |
Das dwRefreshRate-Element ist gültig. |
DDSD_SRCVBHANDLE |
Der dwSrcVBHandle-Member ist gültig. |
DDSD_TEXTURESTAGE |
Der dwTextureStage-Member ist gültig. |
DDSD_WIDTH |
Das dwWidth-Element ist gültig. |
DDSD_ZBUFFERBITDEPTH |
Dieses Flag wird in DDSURFACEDESC2 nicht verwendet. Es wird nur in DDSURFACEDESC verwendet. |
dwHeight
Gibt die Höhe der Oberfläche in Pixel an.
dwWidth
Gibt die Breite der Oberfläche in Pixel an.
DUMMYUNIONNAMEN
–
DUMMYUNIONNAMEN.lPitch
Gibt die Anzahl der Bytes zwischen den Anfängen von zwei benachbarten Scanzeilen an. d. h. die Anzahl der Bytes, die der Anfangsadresse einer Scanzeile hinzugefügt werden sollen, um die Anfangsadresse der nächsten Scanzeile darunter zu erreichen. Der DdCreateSurface-Rückruf des Treibers muss diesen Wert zurückgeben.
DUMMYUNIONNAMEN.dwLinearSize
Gibt die Größe einer formlosen, spät zugeordneten, optimierten Oberfläche in Bytes an.
DUMMYUNIONNAMEN.dwBackBufferCount
Gibt die Anzahl der Zurückpuffer an, die der Oberfläche zugeordnet sind.
DUMMYUNIONNAMEN.dwDepth
Die Bittiefe, wenn es sich um eine Volumetextur handelt.
DUMMYUNIONNAMEN.dwMipMapCount
Gibt die Anzahl der Mipmap-Ebenen an.
DUMMYUNIONNAMEN.dwRefreshRate
Gibt die Aktualisierungsrate des Monitors in Hertz an (wird verwendet, wenn der Anzeigemodus beschrieben wird).
DUMMYUNIONNAMEN.dwSrcVBHandle
Gibt die Quelle an, die in IDirect3DVertexBuffer7::Optimize verwendet wird (in der Dokumentation zum Microsoft Direct3D SDK beschrieben).
dwAlphaBitDepth
Gibt die Tiefe des Alphapuffers in Bits pro Pixel an.
dwReserved
Reserviert, und sollte auf 0 festgelegt werden.
lpSurface
Gibt die Adresse des zugeordneten Oberflächenspeichers an.
DUMMYUNIONNAMEN.ddckCKDestOverlay
Gibt den Farbschlüssel für die Verwendung von Zielüberlagerungen an.
DUMMYUNIONNAMEN.dwEmptyFaceColor
Gibt die physische Farbe für leere Cubezuordnungsflächen an.
ddckCKDestBlt
Gibt den Farbschlüssel für die Verwendung von Zielblit an.
ddckCKSrcOverlay
Gibt den Farbschlüssel für die Verwendung von Quellüberlagerungen an.
ddckCKSrcBlt
Gibt den Farbschlüssel für die Verwendung von Quellspalten an.
DUMMYUNIONNAMEN.ddpfPixelFormat
Gibt eine DDPIXELFORMAT-Struktur an, die das Pixelformat der Oberfläche beschreibt.
DUMMYUNIONNAMEN.dwFVF
Gibt das flexible Vertexformat (D3DFVF) für die Vertexpuffer an.
ddsCaps
Gibt eine DDSCAPS-Struktur an, die die DirectDraw-Oberflächenfunktionen enthält.
dwTextureStage
Gibt die Phase in der Multitexture-Kaskade an. Weitere Informationen finden Sie unter Texturphasen.
Hinweise
Die relevanten Elemente unterscheiden sich für jeden potenziellen Oberflächentyp. Diese Struktur wird in der Regel von einer Anwendung erstellt und initialisiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | ddraw.h |