estrutura DD_GETEXTENDEDMODEDATA (d3dhal.h)

Artigo
02/26/2024

Somente DirectX 9.0 e versões posteriores.

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

Sintaxe

typedef struct _DD_GETEXTENDEDMODEDATA {
  DD_GETDRIVERINFO2DATA gdi2;
  DWORD                 dwModeIndex;
  D3DDISPLAYMODE        mode;
} DD_GETEXTENDEDMODEDATA;

Membros

gdi2

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

dwModeIndex

Especifica o índice do modo de exibição a ser retornado.

mode

Recebe uma estrutura D3DDISPLAYMODE que especifica o modo de exibição real.

Comentários

O runtime identifica o modo de exibição a ser retornado com um índice inteiro cujo valor varia entre zero e um menor que o número de modos de exibição com suporte relatados anteriormente pelo driver em uma consulta DD_GETDRIVERINFO2DATA com o tipo D3DGDI2_TYPE_GETEXTENDEDMODECOUNT. A forma como esses índices são mapeados para os modos de exibição reais é deixado para o driver. No entanto, cada índice deve mapear exclusivamente para um modo de exibição com suporte. A ordem na qual os modos de exibição são relatados não é significativa.

Ao processar essa solicitação GetDriverInfo2 , o driver deve ler o valor no membro dwModeIndex e mapear esse valor para um dos modos de exibição com suporte (provavelmente usando o valor em dwModeIndex como um índice em uma matriz de estruturas D3DDISPLAYMODE). Em seguida, o driver deve copiar esse modo de exibição para o membro do modo . 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 modos de exibição relatados pelo driver. O intervalo do índice deve ser validado no build do driver de depuração.

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