Compartilhar via

estrutura DDSURFACEDESC2 (ddraw.h)

  • Artigo

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