Estructura DDSURFACEDESC (ddraw.h)
La estructura DDSURFACEDESC contiene una descripción de una superficie que el controlador va a crear.
Sintaxis
typedef struct _DDSURFACEDESC {
DWORD dwSize;
DWORD dwFlags;
DWORD dwHeight;
DWORD dwWidth;
#if ...
union {
LONG lPitch;
DWORD dwLinearSize;
} DUMMYUNIONNAMEN;
DWORD dwBackBufferCount;
#else
union {
DWORD dwMipMapCount;
DWORD dwZBufferBitDepth;
DWORD dwRefreshRate;
} DUMMYUNIONNAMEN;
#endif
DWORD dwAlphaBitDepth;
DWORD dwReserved;
LPVOID lpSurface;
DDCOLORKEY ddckCKDestOverlay;
DDCOLORKEY ddckCKDestBlt;
DDCOLORKEY ddckCKSrcOverlay;
DDCOLORKEY ddckCKSrcBlt;
DDPIXELFORMAT ddpfPixelFormat;
DDSCAPS ddsCaps;
} *LPDDSURFACEDESC, DDSURFACEDESC;
Miembros
dwSize
Especifica el tamaño en bytes de esta estructura DDSURFACEDESC. Este miembro debe inicializarse antes de usar la estructura.
dwFlags
Especifica un conjunto de marcas que determinan qué miembros de la estructura DDSURFACEDESC 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_HEIGHT |
El miembro dwHeight es válido. |
DDSD_LINEARSIZE |
El miembro dwLinearSize 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_WIDTH |
El miembro dwWidth es válido. |
DDSD_ZBUFFERBITDEPTH |
El miembro dwZBufferBitDepth es válido. |
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 sin formato asignada en tiempo de demora.
dwBackBufferCount
Especifica el número de búferes de reserva asociados a la superficie.
DUMMYUNIONNAMEN.dwMipMapCount
Especifica el número de niveles de mapa mip.
DUMMYUNIONNAMEN.dwZBufferBitDepth
Especifica la profundidad del búfer z en bits por píxel.
DUMMYUNIONNAMEN.dwRefreshRate
Especifica la frecuencia de actualización en hercios del monitor (se usa cuando se describe el modo de presentación).
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.
ddckCKDestOverlay
Especifica la clave de color para el uso de superposición de destino.
ddckCKDestBlt
Especifica la clave de color para el uso de blt 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 blt de origen.
ddpfPixelFormat
Especifica una estructura DDPIXELFORMAT que describe el formato de píxel de la superficie.
ddsCaps
Especifica una estructura DDSCAPS que contiene las funcionalidades de superficie de Microsoft DirectDrawMicrosoft.
Comentarios
Los miembros pertinentes difieren para cada posible tipo de superficie. Normalmente, una aplicación crea e inicializa esta estructura.
Requisitos
| Encabezado | ddraw.h |