Freigeben über


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