DDSURFACEDESC2 struttura (ddraw.h)
La struttura DDSURFACEDESC2 contiene una descrizione di una superficie da creare dal driver.
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;
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.
I membri pertinenti differiscono per ogni tipo potenziale di superficie. Questa struttura viene in genere creata e inizializzata da un'applicazione.
Requisito | Valore |
---|---|
Intestazione | ddraw.h |