DDSURFACEDESC2 struttura (ddraw.h)

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

Sintassi

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;

Members

dwSize

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

dwFlags

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

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.

DUMMYUNIONNAMEN.dwBackBufferCount

Specifica il numero di buffer indietro associati alla superficie.

DUMMYUNIONNAMEN.dwDepth

Profondità bit se si tratta di una trama del volume.

DUMMYUNIONNAMEN.dwMipMapCount

Specifica il numero di livelli mipmap.

DUMMYUNIONNAMEN.dwRefreshRate

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

DUMMYUNIONNAMEN.dwSrcVBHandle

Specifica l'origine usata in IDirect3DVertexBuffer7::Optimize (descritta nella documentazione di Microsoft Direct3D SDK).

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.

DUMMYUNIONNAMEN.ddckCKDestOverlay

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

DUMMYUNIONNAMEN.dwEmptyFaceColor

Specifica il colore fisico per i visi della mappa dei cubi vuoti.

ddckCKDestBlt

Specifica la chiave di colore per l'uso di blit 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 blit di origine.

DUMMYUNIONNAMEN.ddpfPixelFormat

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

DUMMYUNIONNAMEN.dwFVF

Specifica il formato vertex flessibile (D3DFVF) per i buffer dei vertici.

ddsCaps

Specifica una struttura DDSCAPS contenente le funzionalità di superficie DirectDraw.

dwTextureStage

Specifica la fase nella catena multitexture. Per altre informazioni, vedere Fasi trama.

Commenti

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

Requisiti

Vedi anche

• DdCreateSurface
• DDPIXELFORMAT
• DDSCAPS