estrutura DD_MULTISAMPLEQUALITYLEVELSDATA (d3dhal.h)

Artigo
02/23/2024

Somente DirectX 9.0 e versões posteriores.

DD_MULTISAMPLEQUALITYLEVELSDATA é a estrutura de dados apontada pelo campo lpvData de DD_GETDRIVERINFODATA para consultas DD_GETDRIVERINFO2DATA com o tipo D3DGDI2_TYPE_GETMULTISAMPLEQUALITYLEVELS.

Sintaxe

typedef struct _DD_MULTISAMPLEQUALITYLEVELSDATA {
  DD_GETDRIVERINFO2DATA gdi2;
  D3DFORMAT             Format;
  BOOL                  bFlip : 1;
  D3DMULTISAMPLE_TYPE   MSType : 31;
  DWORD                 QualityLevels;
} DD_MULTISAMPLEQUALITYLEVELSDATA;

Membros

gdi2

Especifica uma estrutura DD_GETDRIVERINFO2DATA que contém os dados GetDriverInfo2 .

Format

Usa um valor da enumeração D3DFORMAT para especificar o formato de superfície do destino de renderização de várias amostras.

bFlip

Indica o tipo de resolução. Defina como TRUE (1) para resolução de estilo flip e como FALSE (0) para resolução de estilo blt.

MSType

Usa um valor da enumeração D3DMULTISAMPLE_TYPE para especificar o nível de multisampling de cena completa. Se o dispositivo de exibição der suporte a multiamostragem mascarada (mais de um exemplo para um formato de destino de renderização de vários exemplos mais suporte a suavizações), o driver do dispositivo deverá fornecer o número de níveis de qualidade para o valor enumerado de D3DMULTISAMPLE_NONMASKABLE (1).

QualityLevels

Recebe o número de níveis de qualidade de vários exemplos aos quais o driver dá suporte para o formato de destino de renderização especificado.

Comentários

O driver atribui um inteiro de 1 a 8 ao membro QualityLevels . Se o driver falhar, ignorará essa consulta D3DGDI2_TYPE_GETMULTISAMPLEQUALITYLEVELS ou retornará um valor fora do intervalo, mas, caso contrário, relatará que ele dá suporte a várias amostras, então o runtime determinará que o número de níveis de qualidade é 1.

Quando o runtime chama as funções DdCanCreateSurface, DdCreateSurface ou D3dCreateSurfaceEx de um driver para criar uma superfície, o runtime codifica o número de níveis de qualidade de vários exemplos em três bits (a máscara de DDSCAPS3_MULTISAMPLE_QUALITY_MASK) do membro dwCaps3 de uma estrutura DDSCAPS2 .

Para obter mais informações sobre D3DFORMAT e D3DMULTISAMPLE_TYPE, consulte a documentação do SDK do DirectX.