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

Weitere Informationen

• DdCreateSurface
• DDPIXELFORMAT
• DDSCAPS