estrutura DD_MORESURFACECAPS (ddrawint.h)

A estrutura DD_MORESURFACECAPS define mais funcionalidades da superfície do driver, além daquelas descritas em DDCORECAPS.

Sintaxe

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

Membros

dwSize

Especifica o tamanho dessa estrutura DD_MORESURFACECAPS. A estrutura DD_MORESURFACECAPS é de tamanho variável. Deve haver exatamente cópias DD_HALINFO.vmiData.dwNumHeaps da estrutura ddsExtendedHeapRestrictions dentro do membro da matriz dessa estrutura. O tamanho total de uma estrutura DD_MORESURFACECAPS é, portanto:

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

Esse cálculo explica o tamanho mínimo da estrutura DD_MORESURFACECAPS, que inclui apenas um elemento de matriz ddsExtendedHeapRestrictions . Quaisquer elementos de matriz ddsExtendedHeapRestrictions adicionais devem ser contabilizados adicionando os tamanhos dos elementos restantes da matriz. Ou seja, adicionando o produto do número de estruturas ddsExtendedHeapRestrictions restantes vezes o tamanho de cada uma delas.

ddsCapsMore

Especifica uma estrutura DDSCAPSEX que fornece as extensões para ddcaps.ddsCaps que descrevem os tipos de superfícies estendidas que o driver pode criar. Quando uma estrutura DDCAPS é retornada ao aplicativo, é uma estrutura DDSCAPS2 fabricada de DDCAPS.ddsCaps e DD_MORESURFACECAPS.ddsCapsMore. Uma estrutura DDSCAPSEX é igual a uma estrutura DDSCAPS2 sem o membro dwCaps .

tagNTExtendedHeapRestrictions

tagNTExtendedHeapRestrictions.ddsCapsEx

tagNTExtendedHeapRestrictions.ddsCapsExAlt

ddsExtendedHeapRestrictions[1]

Especifica uma estrutura que contém dois membros. Esses membros são preenchidos por drivers com reconhecimento do Microsoft DirectX 6.0 (e drivers compatíveis com versões posteriores do DirectX), para restringir os heaps de memória de vídeo expostos ao Microsoft DirectDraw a determinados conjuntos de bits DDSCAPS_Xxx . A versão do DirectDraw é determinada examinando DDVERSIONINFO, que é definido em ddrawi.h. Os membros ddsCapsEx e ddsCapsExAlt da estrutura DD_MORESURFACECAPS são exatamente análogos aos membros ddsCaps e ddsCapsAlt das estruturas VIDEOMEMORY listadas no membro VIDMEMINFO.pvmList de DD_HALINFO.vmiData.

ddsCapsEx

Especifica uma estrutura DDSCAPSEX na qual o driver retorna os recursos para os quais essa parte da memória não pode ser usada.

ddsCapsExAlt

Especifica uma estrutura DDSCAPSEX na qual o driver retorna os recursos para os quais essa parte da memória não pode ser usada quando nenhuma outra memória é encontrada na primeira passagem.

Comentários

Essa estrutura contém os bits caps adicionados à estrutura DDCAPS.ddsCaps no DirectX 6.0. Consulte a documentação do SDK do DirectDraw para obter uma descrição da estrutura DDCAPS.

Observação para o Microsoft Windows 98/Me: DD_MORESURFACECAPS é a definição para o Windows 2000 e versões posteriores. Os drivers executados no Windows 98/Me usam o nome DDMORESURFACECAPS, que é alias em dx95type.h.

Requisitos

Confira também

DDCORECAPS

DDSCAPS2