estrutura DD_GETD3DQUERYDATA (d3dhal.h)

Artigo
02/23/2024

Somente o DirectX 9.0 e versões posteriores.

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

Sintaxe

typedef struct _DD_GETD3DQUERYDATA {
  DD_GETDRIVERINFO2DATA gdi2;
  union {
    DWORD        dwQueryIndex;
    D3DQUERYTYPE QueryType;
  };
} DD_GETD3DQUERYDATA;

Membros

gdi2

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

dwQueryIndex

Especifica o índice do tipo de consulta a ser retornado.

QueryType

Recebe um valor da enumeração D3DQUERYTYPE que especifica o recurso de consulta real.

Comentários

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

Ao processar essa solicitação GetDriverInfo2 , o driver deve ler o valor na união como se fosse o membro dwQueryIndex e mapear esse valor para um dos tipos de consulta com suporte (provavelmente usando o valor em dwQueryIndex como um índice em uma matriz de valores de D3DQUERYTYPE). Em seguida, o driver deve copiar esse tipo de consulta para a união como se fosse o membro QueryType . 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 tipos de consulta relatados pelo driver. O intervalo do índice deve ser validado no build do driver de depuração.

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