estrutura DD_GETD3DQUERYDATA (d3dhal.h)

Artigo
02/06/2025

Somente versões posteriores e DirectX 9.0.

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 de DD_GETDRIVERINFO2DATA que contém os dados do 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.

Observações

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

Ao processar esse GetDriverInfo2 solicitação, 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 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.