Struttura DDSURFACEDESC (ddraw.h)

  • Articolo

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