estrutura DDSURFACEDESC2 (ddraw.h)

A estrutura DDSURFACEDESC2 contém uma descrição de uma superfície a ser criada pelo driver.

Sintaxe

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;

Membros

dwSize

Especifica o tamanho em bytes dessa estrutura DDSURFACEDESC2. Esse membro deve ser inicializado antes que a estrutura seja usada.

dwFlags

Especifica um conjunto de sinalizadores que determinam quais membros da estrutura DDSURFACEDESC2 contêm dados válidos. Esse membro pode ser um ou mais dos seguintes sinalizadores:

Sinalizador	Significado
DDSD_ALL	Todos os membros de entrada contêm dados válidos.
DDSD_ALPHABITDEPTH	O membro dwAlphaBitDepth é válido.
DDSD_BACKBUFFERCOUNT	O membro dwBackBufferCount é válido.
DDSD_CAPS	O membro ddsCaps é válido.
DDSD_CKDESTBLT	O membro ddckCKDestBlt é válido.
DDSD_CKDESTOVERLAY	O membro ddckCKDestOverlay é válido.
DDSD_CKSRCBLT	O membro ddckCKSrcBlt é válido.
DDSD_CKSRCOVERLAY	O membro ddckCKSrcOverlay é válido.
DDSD_FVF	O membro dwFVF é válido.
DDSD_HEIGHT	O membro dwHeight é válido.
DDSD_LINEARSIZE	O membro dwLinearSize é válido.
DDSD_LPSURFACE	O membro lpSurface é válido.
DDSD_MIPMAPCOUNT	O membro dwMipMapCount é válido.
DDSD_PITCH	O membro lPitch é válido.
DDSD_PIXELFORMAT	O membro ddpfPixelFormat é válido.
DDSD_REFRESHRATE	O membro dwRefreshRate é válido.
DDSD_SRCVBHANDLE	O membro dwSrcVBHandle é válido.
DDSD_TEXTURESTAGE	O membro dwTextureStage é válido.
DDSD_WIDTH	O membro dwWidth é válido.
DDSD_ZBUFFERBITDEPTH	Esse sinalizador não é usado em DDSURFACEDESC2. Ele só é usado em DDSURFACEDESC.

dwHeight

Especifica a altura da superfície em pixels.

dwWidth

Especifica a largura da superfície em pixels.

DUMMYUNIONNAMEN

N/D

DUMMYUNIONNAMEN.lPitch

Especifica o número de bytes entre o início de duas linhas de verificação adjacentes; ou seja, o número de bytes a serem adicionados ao endereço inicial de uma linha de verificação para alcançar o endereço inicial da próxima linha de verificação abaixo dela. O retorno de chamada DdCreateSurface do driver deve retornar esse valor.

DUMMYUNIONNAMEN.dwLinearSize

Especifica o tamanho em bytes de uma superfície otimizada, com alocação tardia e sem forma.

DUMMYUNIONNAMEN.dwBackBufferCount

Especifica o número de buffers traseiros associados à superfície.

DUMMYUNIONNAMEN.dwDepth

A profundidade do bit se essa for uma textura de volume.

DUMMYUNIONNAMEN.dwMipMapCount

Especifica o número de níveis de mipmap.

DUMMYUNIONNAMEN.dwRefreshRate

Especifica a taxa de atualização em hertz do monitor (usado quando o modo de exibição é descrito).

DUMMYUNIONNAMEN.dwSrcVBHandle

Especifica a origem usada em IDirect3DVertexBuffer7::Optimize (descrito na documentação do SDK do Microsoft Direct3D).

dwAlphaBitDepth

Especifica a profundidade do buffer alfa em bits por pixel.

dwReserved

Reservado e deve ser definido como zero.

lpSurface

Especifica o endereço da memória de superfície associada.

DUMMYUNIONNAMEN.ddckCKDestOverlay

Especifica a chave de cor para uso de sobreposição de destino.

DUMMYUNIONNAMEN.dwEmptyFaceColor

Especifica a cor física para rostos vazios do mapa de cubos.

ddckCKDestBlt

Especifica a chave de cor para uso de blit de destino.

ddckCKSrcOverlay

Especifica a chave de cor para uso de sobreposição de origem.

ddckCKSrcBlt

Especifica a chave de cor para uso blit de origem.

DUMMYUNIONNAMEN.ddpfPixelFormat

Especifica uma estrutura DDPIXELFORMAT que descreve o formato de pixel da superfície.

DUMMYUNIONNAMEN.dwFVF

Especifica o Formato de Vértice Flexível (D3DFVF) para os buffers de vértice.

ddsCaps

Especifica uma estrutura DDSCAPS que contém os recursos de superfície do DirectDraw.

dwTextureStage

Especifica o estágio na cascata de multitextura. Para obter mais informações, consulte Estágios de textura.

Comentários

Os membros relevantes diferem para cada tipo potencial de superfície. Normalmente, essa estrutura é criada e inicializada por um aplicativo.

Requisitos

Requisito	Valor
Cabeçalho	ddraw.h

Confira também

• DdCreateSurface
• DDPIXELFORMAT
• DDSCAPS