DDSURFACEDESC2 structure (ddraw.h)

  • Article

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

Syntaxe

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;

Membres

dwSize

Spécifie la taille en octets de cette structure DDSURFACEDESC2. 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 de DDSURFACEDESC2 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_FVF

Le membre dwFVF est valide.

DDSD_HEIGHT

Le membre dwHeight est valide.

DDSD_LINEARSIZE

Le membre dwLinearSize est valide.

DDSD_LPSURFACE

Le membre lpSurface 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_SRCVBHANDLE

Le membre dwSrcVBHandle est valide.

DDSD_TEXTURESTAGE

Le membre dwTextureStage est valide.

DDSD_WIDTH

Le membre dwWidth est valide.

DDSD_ZBUFFERBITDEPTH

Cet indicateur n’est pas utilisé dans DDSURFACEDESC2. Il est utilisé uniquement dans DDSURFACEDESC.

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.

DUMMYUNIONNAMEN.dwBackBufferCount

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

DUMMYUNIONNAMEN.dwDepth

Profondeur de bits s’il s’agit d’une texture de volume.

DUMMYUNIONNAMEN.dwMipMapCount

Spécifie le nombre de niveaux de mipmap.

DUMMYUNIONNAMEN.dwRefreshRate

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

DUMMYUNIONNAMEN.dwSrcVBHandle

Spécifie la source utilisée dans IDirect3DVertexBuffer7 ::Optimize (décrit dans la documentation du Kit de développement logiciel (SDK) Microsoft Direct3D).

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.

DUMMYUNIONNAMEN.ddckCKDestOverlay

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

DUMMYUNIONNAMEN.dwEmptyFaceColor

Spécifie la couleur physique des visages de carte de cube vides.

ddckCKDestBlt

Spécifie la clé de couleur pour l’utilisation de la fente 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 la fente source.

DUMMYUNIONNAMEN.ddpfPixelFormat

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

DUMMYUNIONNAMEN.dwFVF

Spécifie le format de vertex flexible (D3DFVF) pour les mémoires tampons de vertex.

ddsCaps

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

dwTextureStage

Spécifie la phase dans la cascade multitexte. Pour plus d’informations, consultez Étapes de texture.

Remarques

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.

Configuration requise

Condition requise Valeur
En-tête ddraw.h

Voir aussi