DDSURFACEDESC-Struktur (ddraw.h)
Die DDSURFACEDESC-Struktur enthält eine Beschreibung einer Oberfläche, die vom Treiber erstellt werden soll.
Syntax
typedef struct _DDSURFACEDESC {
DWORD dwSize;
DWORD dwFlags;
DWORD dwHeight;
DWORD dwWidth;
#if ...
union {
LONG lPitch;
DWORD dwLinearSize;
} DUMMYUNIONNAMEN;
DWORD dwBackBufferCount;
#else
union {
DWORD dwMipMapCount;
DWORD dwZBufferBitDepth;
DWORD dwRefreshRate;
} DUMMYUNIONNAMEN;
#endif
DWORD dwAlphaBitDepth;
DWORD dwReserved;
LPVOID lpSurface;
DDCOLORKEY ddckCKDestOverlay;
DDCOLORKEY ddckCKDestBlt;
DDCOLORKEY ddckCKSrcOverlay;
DDCOLORKEY ddckCKSrcBlt;
DDPIXELFORMAT ddpfPixelFormat;
DDSCAPS ddsCaps;
} *LPDDSURFACEDESC, DDSURFACEDESC;
Member
dwSize
Gibt die Größe dieser DDSURFACEDESC-Struktur in Bytes an. Dieser Member muss initialisiert werden, bevor die -Struktur verwendet wird.
dwFlags
Gibt eine Reihe von Flags an, die bestimmen, welche Member der DDSURFACEDESC-Struktur gültige Daten enthalten. Bei diesem Member kann es sich um ein oder mehrere 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_HEIGHT |
Das dwHeight-Element ist gültig. |
DDSD_LINEARSIZE |
Das dwLinearSize-Element ist gültig. |
DDSD_MIPMAPCOUNT |
Das dwMipMapCount-Element ist gültig. |
DDSD_PITCH |
Das lPitch-Element ist gültig. |
DDSD_PIXELFORMAT |
Das ddpfPixelFormat-Element ist gültig. |
DDSD_REFRESHRATE |
Das dwRefreshRate-Element ist gültig. |
DDSD_WIDTH |
Das dwWidth-Element ist gültig. |
DDSD_ZBUFFERBITDEPTH |
Das dwZBufferBitDepth-Element ist gültig. |
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 von Bytes zwischen den Anfängen zweier benachbarter 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äter zugeordneten, optimierten Oberfläche in Bytes an.
dwBackBufferCount
Gibt die Anzahl der Zurückpuffer an, die der Oberfläche zugeordnet sind.
DUMMYUNIONNAMEN.dwMipMapCount
Gibt die Anzahl der Mipmap-Ebenen an.
DUMMYUNIONNAMEN.dwZBufferBitDepth
Gibt die Tiefe des Z-Puffers in Bits pro Pixel an.
DUMMYUNIONNAMEN.dwRefreshRate
Gibt die Aktualisierungsrate im Hertz des Monitors an (wird verwendet, wenn der Anzeigemodus beschrieben wird).
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.
ddckCKDestOverlay
Gibt den Farbschlüssel für die Verwendung von Zielüberlagerungen an.
ddckCKDestBlt
Gibt den Farbschlüssel für die Verwendung von Ziel-BLT an.
ddckCKSrcOverlay
Gibt den Farbschlüssel für die Verwendung der Quellüberlagerung an.
ddckCKSrcBlt
Gibt den Farbschlüssel für die Verwendung von Quell-BLT an.
ddpfPixelFormat
Gibt eine DDPIXELFORMAT-Struktur an, die das Pixelformat der Oberfläche beschreibt.
ddsCaps
Gibt eine DDSCAPS-Struktur an, die die Microsoft DirectDrawMicrosoft-Oberflächenfunktionen enthält.
Bemerkungen
Die relevanten Member unterscheiden sich für jeden potenziellen Oberflächentyp. Diese Struktur wird in der Regel von einer Anwendung erstellt und initialisiert.
Anforderungen
| Kopfzeile | ddraw.h |