Structure DDSURFACEDESC (ddraw.h)

La structure DDSURFACEDESC contient une description d’une surface à créer par le pilote.

Syntaxe

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;

Membres

dwSize

Spécifie la taille en octets de cette structure DDSURFACEDESC. Ce membre doit être initialisé avant l’utilisation de la structure.

dwFlags

Spécifie un ensemble d’indicateurs qui déterminent quels membres de la structure DDSURFACEDESC contiennent des données valides. Ce membre peut être un ou plusieurs des indicateurs suivants :

Indicateur	Signification
DDSD_ALL	Tous les membres d’entrée contiennent des données valides.
DDSD_ALPHABITDEPTH	Le membre dwAlphaBitDepth est valide.
DDSD_BACKBUFFERCOUNT	Le membre dwBackBufferCount est valide.
DDSD_CAPS	Le membre ddsCaps est valide.
DDSD_CKDESTBLT	Le membre ddckCKDestBlt est valide.
DDSD_CKDESTOVERLAY	Le membre ddckCKDestOverlay est valide.
DDSD_CKSRCBLT	Le membre ddckCKSrcBlt est valide.
DDSD_CKSRCOVERLAY	Le membre ddckCKSrcOverlay est valide.
DDSD_HEIGHT	Le membre dwHeight est valide.
DDSD_LINEARSIZE	Le membre dwLinearSize est valide.
DDSD_MIPMAPCOUNT	Le membre dwMipMapCount est valide.
DDSD_PITCH	Le membre lPitch est valide.
DDSD_PIXELFORMAT	Le membre ddpfPixelFormat est valide.
DDSD_REFRESHRATE	Le membre dwRefreshRate est valide.
DDSD_WIDTH	Le membre dwWidth est valide.
DDSD_ZBUFFERBITDEPTH	Le membre dwZBufferBitDepth est valide.

dwHeight

Spécifie la hauteur de la surface, en pixels.

dwWidth

Spécifie la largeur de la surface, en pixels.

DUMMYUNIONNAMEN

N/A

DUMMYUNIONNAMEN.lPitch

Spécifie le nombre d’octets entre les débuts de deux lignes d’analyse adjacentes ; c’est-à-dire le nombre d’octets à ajouter à l’adresse de début d’une ligne d’analyse pour atteindre l’adresse de début de la ligne d’analyse suivante en dessous. Le rappel DdCreateSurface du pilote doit retourner cette valeur.

DUMMYUNIONNAMEN.dwLinearSize

Spécifie la taille en octets d’une surface optimisée, allouée tardivement et sans forme.

dwBackBufferCount

Spécifie le nombre de mémoires tampons d’arrière-mémoire associées à la surface.

DUMMYUNIONNAMEN.dwMipMapCount

Spécifie le nombre de niveaux de mipmap.

DUMMYUNIONNAMEN.dwZBufferBitDepth

Spécifie la profondeur de z-buffer en bits par pixel.

DUMMYUNIONNAMEN.dwRefreshRate

Spécifie la fréquence d’actualisation en hertz du moniteur (utilisée lorsque le mode d’affichage est décrit).

dwAlphaBitDepth

Spécifie la profondeur de la mémoire tampon alpha en bits par pixel.

dwReserved

Réservé, et doivent être définis sur zéro.

lpSurface

Spécifie l’adresse de la mémoire de surface associée.

ddckCKDestOverlay

Spécifie la clé de couleur pour l’utilisation de la superposition de destination.

ddckCKDestBlt

Spécifie la clé de couleur pour l’utilisation blt de destination.

ddckCKSrcOverlay

Spécifie la clé de couleur pour l’utilisation de la superposition de source.

ddckCKSrcBlt

Spécifie la clé de couleur pour l’utilisation de blt source.

ddpfPixelFormat

Spécifie une structure DDPIXELFORMAT qui décrit le format de pixels de la surface.

ddsCaps

Spécifie une structure DDSCAPS qui contient les fonctionnalités de Microsoft DirectDrawMicrosoft surface.

Notes

Les membres pertinents diffèrent pour chaque type de surface potentiel. Cette structure est généralement créée et initialisée par une application.

Spécifications

En-tête	ddraw.h

Voir aussi

• DdCreateSurface
• DDPIXELFORMAT
• DDSCAPS