Struttura DDSURFACEDESC (ddraw.h)

La struttura DDSURFACEDESC contiene una descrizione di una superficie da creare dal driver.

Sintassi

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;

Members

dwSize

Specifica le dimensioni in byte di questa struttura DDSURFACEDESC. Questo membro deve essere inizializzato prima dell'uso della struttura.

dwFlags

Specifica un set di flag che determinano quali membri della struttura DDSURFACEDESC contengono dati validi. Questo membro può essere uno o più dei flag seguenti:

Flag	Significato
DDSD_ALL	Tutti i membri di input contengono dati validi.
DDSD_ALPHABITDEPTH	Il membro dwAlphaBitDepth è valido.
DDSD_BACKBUFFERCOUNT	Il membro dwBackBufferCount è valido.
DDSD_CAPS	Il membro ddsCaps è valido.
DDSD_CKDESTBLT	Il membro ddckCKDestBlt è valido.
DDSD_CKDESTOVERLAY	Il membro ddckCKDestOverlay è valido.
DDSD_CKSRCBLT	Il membro ddckCKSrcBlt è valido.
DDSD_CKSRCOVERLAY	Il membro ddckCKSrcOverlay è valido.
DDSD_HEIGHT	Il membro dwHeight è valido.
DDSD_LINEARSIZE	Il membro dwLinearSize è valido.
DDSD_MIPMAPCOUNT	Il membro dwMipMapCount è valido.
DDSD_PITCH	Il membro lPitch è valido.
DDSD_PIXELFORMAT	Il membro ddpfPixelFormat è valido.
DDSD_REFRESHRATE	Il membro dwRefreshRate è valido.
DDSD_WIDTH	Il membro dwWidth è valido.
DDSD_ZBUFFERBITDEPTH	Il membro dwZBufferBitDepth è valido.

dwHeight

Specifica l'altezza della superficie, in pixel.

dwWidth

Specifica la larghezza della superficie, in pixel.

DUMMYUNIONNAMEN

N/D

DUMMYUNIONNAMEN.lPitch

Specifica il numero di byte tra l'inizio di due righe di analisi adiacenti; ovvero il numero di byte da aggiungere all'indirizzo iniziale di una riga di analisi per raggiungere l'indirizzo iniziale della riga di analisi successiva. Il callback DdCreateSurface del driver deve restituire questo valore.

DUMMYUNIONNAMEN.dwLinearSize

Specifica le dimensioni in byte di una superficie senza forma, allocata in ritardo, ottimizzata.

dwBackBufferCount

Specifica il numero di buffer indietro associati alla superficie.

DUMMYUNIONNAMEN.dwMipMapCount

Specifica il numero di livelli mipmap.

DUMMYUNIONNAMEN.dwZBufferBitDepth

Specifica la profondità del buffer z in bit per pixel.

DUMMYUNIONNAMEN.dwRefreshRate

Specifica la frequenza di aggiornamento in hertz del monitor (utilizzata quando viene descritta la modalità di visualizzazione).

dwAlphaBitDepth

Specifica la profondità del buffer alfa in bit per pixel.

dwReserved

Riservato e deve essere impostato su zero.

lpSurface

Specifica l'indirizzo della memoria di superficie associata.

ddckCKDestOverlay

Specifica la chiave di colore per l'uso della sovrapposizione di destinazione.

ddckCKDestBlt

Specifica la chiave di colore per l'uso blt di destinazione.

ddckCKSrcOverlay

Specifica la chiave di colore per l'uso della sovrapposizione di origine.

ddckCKSrcBlt

Specifica la chiave di colore per l'uso di blt di origine.

ddpfPixelFormat

Specifica una struttura DDPIXELFORMAT che descrive il formato pixel della superficie.

ddsCaps

Specifica una struttura DDSCAPS contenente le funzionalità di superficie Microsoft DirectDrawMicrosoft.

Commenti

I membri pertinenti differiscono per ogni tipo potenziale di superficie. Questa struttura viene in genere creata e inizializzata da un'applicazione.

Requisiti

Intestazione	ddraw.h

Vedi anche

• DdCreateSurface
• DDPIXELFORMAT
• DDSCAPS