estrutura DD_GETFORMATDATA (d3dhal.h)

Somente DirectX 8.0 e versões posteriores.

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

Sintaxe

typedef struct _DD_GETFORMATDATA {
  DD_GETDRIVERINFO2DATA gdi2;
  DWORD                 dwFormatIndex;
  DDPIXELFORMAT         format;
} DD_GETFORMATDATA;

Membros

gdi2

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

dwFormatIndex

Especifica o índice do formato de pixel a ser retornado.

format

Recebe o formato de pixel real em uma estrutura DDPIXELFORMAT .

Comentários

O runtime identifica o formato a ser retornado com um índice inteiro cujo valor varia entre zero e um menor que o número de formatos com suporte relatados anteriormente pelo driver. A forma como esses índices são mapeados para formatos reais é deixada para o driver. No entanto, cada índice deve mapear exclusivamente para um formato com suporte. A ordem na qual os formatos são relatados não é significativa.

Ao processar essa solicitação GetDriverInfo2 , o driver deve ler o dwFormatIndex e mapeá-lo para um dos formatos com suporte (provavelmente usando dwFormatIndex como um índice em uma matriz de estruturas DDPIXELFORMAT) e, em seguida, copiar esse formato para o campo de formato do campo DD_GETFORMATDATA. O runtime garante que ele passe apenas um índice para o driver que está no intervalo de zero a um a menos do que o número de formatos de superfície relatados pelo driver. O intervalo do índice deve ser validado no build do driver de depuração.

Somente DirectX 9.0 e versões posteriores.Na entrada, a versão do runtime do DirectX que está sendo usada pelo aplicativo é especificada no membro dwSize da estrutura DDPIXELFORMAT no formato . Esse membro dwSize é definido como DD_RUNTIME_VERSION, que é 0x00000900 para DirectX 9.0.

Requisitos

Confira também

DDPIXELFORMAT

DD_GETDRIVERINFO2DATA

DD_GETDRIVERINFODATA