Partager via

Structure DDSURFACEDESC (ddraw.h)

  • Article

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