struttura DD_MORESURFACECAPS (ddrawint.h)

La struttura DD_MORESURFACECAPS definisce più funzionalità della superficie di driver oltre a quelle descritte in DDCORECAPS.

Sintassi

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

Members

dwSize

Specifica le dimensioni di questa struttura DD_MORESURFACECAPS. La struttura DD_MORESURFACECAPS è di dimensioni variabili. Deve essere presente esattamente DD_HALINFO.vmiData.dwNumHeaps copie della struttura ddsExtendedHeapRestrictions all'interno del membro della matrice di questa struttura. Le dimensioni totali di una struttura DD_MORESURFACECAPS sono quindi:

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

Questo calcolo rappresenta la dimensione minima della struttura DD_MORESURFACECAPS, che include un solo elemento di matrice ddsExtendedHeapRestrictions . Tutti gli elementi della matrice ddsExtendedHeapRestrictions aggiuntivi devono essere considerati aggiungendo le dimensioni degli elementi della matrice rimanenti. Vale a dire, aggiungendo il prodotto del numero di strutture ddsExtendedHeapRestrictions rimanenti volte le dimensioni di ognuna.

ddsCapsMore

Specifica una struttura DDSCAPSEX che fornisce le estensioni a ddcaps.ddsCaps che descrivono i tipi di superfici estese che il driver può creare. Quando viene restituita una struttura DDCAPS all'applicazione, si tratta di una struttura DDSCAPS2 prodotta da DDCAPS.ddsCaps e DD_MORESURFACECAPS.ddsCapsMore. Una struttura DDSCAPSEX corrisponde a una struttura DDSCAPS2 senza il membro dwCaps .

tagNTExtendedHeapRestrictions

tagNTExtendedHeapRestrictions.ddsCapsEx

tagNTExtendedHeapRestrictions.ddsCapsExAlt

ddsExtendedHeapRestrictions[1]

Specifica una struttura contenente due membri. Questi membri vengono compilati da driver compatibili con Microsoft DirectX 6.0 (e driver conformi alle versioni successive di DirectX), per limitare gli heap di memoria video esposti a Microsoft DirectDraw a determinati set di bit DDSCAPS_Xxx . La versione di DirectDraw è determinata esaminando DDVERSIONINFO, definito in ddrawi.h. I membri ddsCapsEx e ddsCapsExAlt della struttura DD_MORESURFACECAPS sono esattamente analoghi ai membri ddsCaps e ddsCapsAlt delle strutture VIDEOMEMORY elencate nel membro VIDMEMINFO.pvmList di DD_HALINFO.vmiData.

ddsCapsEx

Specifica una struttura DDSCAPSEX in cui il driver restituisce le funzionalità per cui non è possibile usare questo blocco di memoria.

ddsCapsExAlt

Specifica una struttura DDSCAPSEX in cui il driver restituisce le funzionalità per cui non è possibile usare questo blocco di memoria quando non viene trovata alcuna altra memoria al primo passaggio.

Commenti

Questa struttura contiene i bit di estremità aggiunti alla struttura DDCAPS.ddsCaps in DirectX 6.0. Per una descrizione della struttura DDCAPS, vedere la documentazione di DirectDraw SDK.

Nota per Microsoft Windows 98/Me: DD_MORESURFACECAPS è la definizione per Windows 2000 e versioni successive. I driver eseguiti in Windows 98/Me usano il nome DDMORESURFACECAPS, aliased in dx95type.h.

Requisiti

Vedi anche

DDCORECAPS

DDSCAPS2