estructura DDSURFACEDESC2 (ddraw.h)

La estructura DDSURFACEDESC2 contiene una descripción de una superficie que el controlador va a crear.

Sintaxis

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;

Miembros

dwSize

Especifica el tamaño en bytes de esta estructura de DDSURFACEDESC2. Este miembro debe inicializarse antes de usar la estructura.

dwFlags

Especifica un conjunto de marcas que determinan qué miembros de la estructura de DDSURFACEDESC2 contienen datos válidos. Este miembro puede ser una o varias de las marcas siguientes:

Marca	Significado
DDSD_ALL	Todos los miembros de entrada contienen datos válidos.
DDSD_ALPHABITDEPTH	El miembro dwAlphaBitDepth es válido.
DDSD_BACKBUFFERCOUNT	El miembro dwBackBufferCount es válido.
DDSD_CAPS	El miembro ddsCaps es válido.
DDSD_CKDESTBLT	El miembro ddckCKDestBlt es válido.
DDSD_CKDESTOVERLAY	El miembro ddckCKDestOverlay es válido.
DDSD_CKSRCBLT	El miembro ddckCKSrcBlt es válido.
DDSD_CKSRCOVERLAY	El miembro ddckCKSrcOverlay es válido.
DDSD_FVF	El miembro dwFVF es válido.
DDSD_HEIGHT	El miembro dwHeight es válido.
DDSD_LINEARSIZE	El miembro dwLinearSize es válido.
DDSD_LPSURFACE	El miembro lpSurface es válido.
DDSD_MIPMAPCOUNT	El miembro dwMipMapCount es válido.
DDSD_PITCH	El miembro lPitch es válido.
DDSD_PIXELFORMAT	El miembro ddpfPixelFormat es válido.
DDSD_REFRESHRATE	El miembro dwRefreshRate es válido.
DDSD_SRCVBHANDLE	El miembro dwSrcVBHandle es válido.
DDSD_TEXTURESTAGE	El miembro dwTextureStage es válido.
DDSD_WIDTH	El miembro dwWidth es válido.
DDSD_ZBUFFERBITDEPTH	Esta marca no se usa en DDSURFACEDESC2. Solo se usa en DDSURFACEDESC.

dwHeight

Especifica el alto de la superficie en píxeles.

dwWidth

Especifica el ancho de la superficie en píxeles.

DUMMYUNIONNAMEN

N/D

DUMMYUNIONNAMEN.lPitch

Especifica el número de bytes entre los comienzos de dos líneas de examen adyacentes; es decir, el número de bytes que se van a agregar a la dirección inicial de una línea de examen para llegar a la dirección inicial de la siguiente línea de examen debajo de ella. La devolución de llamada DdCreateSurface del controlador debe devolver este valor.

DUMMYUNIONNAMEN.dwLinearSize

Especifica el tamaño en bytes de una superficie optimizada asignada por última vez y sin formato.

DUMMYUNIONNAMEN.dwBackBufferCount

Especifica el número de búferes de reserva asociados a la superficie.

DUMMYUNIONNAMEN.dwDepth

Profundidad de bits si se trata de una textura de volumen.

DUMMYUNIONNAMEN.dwMipMapCount

Especifica el número de niveles de mapa mip.

DUMMYUNIONNAMEN.dwRefreshRate

Especifica la frecuencia de actualización en hercios del monitor (se usa cuando se describe el modo de visualización).

DUMMYUNIONNAMEN.dwSrcVBHandle

Especifica el origen usado en IDirect3DVertexBuffer7::Optimize (descrito en la documentación del SDK de Microsoft Direct3D).

dwAlphaBitDepth

Especifica la profundidad del búfer alfa en bits por píxel.

dwReserved

Reservado y debe establecerse en cero.

lpSurface

Especifica la dirección de la memoria expuesta asociada.

DUMMYUNIONNAMEN.ddckCKDestOverlay

Especifica la clave de color para el uso de superposición de destino.

DUMMYUNIONNAMEN.dwEmptyFaceColor

Especifica el color físico de las caras de mapa de cubo vacías.

ddckCKDestBlt

Especifica la clave de color para el uso de la partición de destino.

ddckCKSrcOverlay

Especifica la clave de color para el uso de superposición de origen.

ddckCKSrcBlt

Especifica la clave de color para el uso de la bifurco de origen.

DUMMYUNIONNAMEN.ddpfPixelFormat

Especifica una estructura DDPIXELFORMAT que describe el formato de píxel de la superficie.

DUMMYUNIONNAMEN.dwFVF

Especifica el formato de vértice flexible (D3DFVF) para los búferes de vértices.

ddsCaps

Especifica una estructura DDSCAPS que contiene las funcionalidades de superficie de DirectDraw.

dwTextureStage

Especifica la fase de la cascada multitexture. Para obtener más información, consulte Fases de textura.

Comentarios

Los miembros pertinentes difieren para cada tipo potencial de superficie. Normalmente, una aplicación crea e inicializa esta estructura.

Requisitos

Requisito	Valor
Header	ddraw.h

Consulte también

• DdCreateSurface
• DDPIXELFORMAT
• DDSCAPS