Leggere in inglese

Condividi tramite


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:

Contrassegno 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_FVF

Il membro dwFVF è valido.

DDSD_HEIGHT

Il membro dwHeight è valido.

DDSD_LINEARSIZE

Il membro dwLinearSize è valido.

DDSD_LPSURFACE

Il membro lpSurface è 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_SRCVBHANDLE

Il membro dwSrcVHandle è valido.

DDSD_TEXTURESTAGE

Il membro dwTextureStage è valido.

DDSD_WIDTH

Il membro dwWidth è valido.

DDSD_ZBUFFERBITDEPTH

Questo flag non viene usato in DDSURFACEDESC2. Viene usato solo in DDSURFACEDESC.

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

Requisito Valore
Intestazione ddraw.h

Vedi anche