structure DD_MORESURFACECAPS (ddrawint.h)

La structure DD_MORESURFACECAPS définit d’autres fonctionnalités de surface de pilote en plus de celles décrites dans DDCORECAPS.

Syntaxe

typedef struct _DD_MORESURFACECAPS {
  DWORD                         dwSize;
  DDSCAPSEX                     ddsCapsMore;
  struct {
    DDSCAPSEX ddsCapsEx;
    DDSCAPSEX ddsCapsExAlt;
  } tagNTExtendedHeapRestrictions;
  tagNTExtendedHeapRestrictions ddsExtendedHeapRestrictions[1];
} *PDD_MORESURFACECAPS, DD_MORESURFACECAPS;

Membres

dwSize

Spécifie la taille de cette structure DD_MORESURFACECAPS. La structure DD_MORESURFACECAPS est de taille variable. Il doit y avoir exactement DD_HALINFO.vmiData.dwNumHeaps de la structure ddsExtendedHeapRestrictions dans le membre de tableau de cette structure. La taille totale d’une structure DD_MORESURFACECAPS est ainsi :

dwSize = 
   sizeof(DD_MORESURFACECAPS) +
   (DD_HALINFO.vmiData.dwNumHeaps - 1) * sizeof(DDSCAPSEX) * 2

Ce calcul prend en compte la taille minimale de la structure DD_MORESURFACECAPS, qui comprend un seul élément de tableau ddsExtendedHeapRestrictions . Tous les éléments de tableau ddsExtendedHeapRestrictions supplémentaires doivent être pris en compte en ajoutant les tailles des éléments de tableau restants. Autrement dit, en ajoutant le produit du nombre de structures ddsExtendedHeapRestrictions restantes fois la taille de chacune d’elles.

ddsCapsMore

Spécifie une structure DDSCAPSEX qui fournit les extensions de ddcaps.ddsCaps qui décrivent les types de surfaces étendues que le pilote peut créer. Lorsqu’une structure DDCAPS est retournée à l’application, il s’agit d’une structure DDSCAPS2 fabriquée à partir de DDCAPS.ddsCaps et DD_MORESURFACECAPS.ddsCapsPlus. Une structure DDSCAPSEX est identique à une structure DDSCAPS2 sans le membre dwCaps .

tagNTExtendedHeapRestrictions

tagNTExtendedHeapRestrictions.ddsCapsEx

tagNTExtendedHeapRestrictions.ddsCapsExAlt

ddsExtendedHeapRestrictions[1]

Spécifie une structure contenant deux membres. Ces membres sont renseignés par des pilotes prenant en charge Microsoft DirectX 6.0 (et des pilotes compatibles avec les versions ultérieures de DirectX), afin de limiter les tas de mémoire vidéo qui sont exposés à Microsoft DirectDraw à certains ensembles de bits DDSCAPS_Xxx . La version de DirectDraw est déterminée en examinant DDVERSIONINFO, qui est défini dans ddrawi.h. Les membres ddsCapsEx et ddsCapsExAlt de la structure DD_MORESURFACECAPS sont exactement analogues aux membres ddsCaps et ddsCapsAlt des structures VIDEOMEMORY répertoriées dans le membre VIDMEMINFO.pvmList de DD_HALINFO.vmiData.

ddsCapsEx

Spécifie une structure DDSCAPSEX dans laquelle le pilote retourne les fonctionnalités pour lesquelles ce segment de mémoire ne peut pas être utilisé.

ddsCapsExAlt

Spécifie une structure DDSCAPSEX dans laquelle le pilote retourne les fonctionnalités pour lesquelles ce segment de mémoire ne peut pas être utilisé quand aucune autre mémoire n’est trouvée lors de la première passe.

Notes

Cette structure contient les bits majuscules ajoutés à la structure DDCAPS.ddsCaps dans DirectX 6.0. Consultez la documentation du Kit de développement logiciel (SDK) DirectDraw pour obtenir une description de la structure DDCAPS.

Remarque pour Microsoft Windows 98/Me : DD_MORESURFACECAPS est la définition de Windows 2000 et versions ultérieures. Les pilotes qui s’exécutent sur Windows 98/Me utilisent le nom DDMORESURFACECAPS, alias dans dx95type.h.

Spécifications

Voir aussi

DDCORECAPS

DDSCAPS2