estrutura DD_GETADAPTERGROUPDATA (d3dhal.h)

Somente DirectX 9.0 e versões posteriores.

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

Sintaxe

typedef struct _DD_GETADAPTERGROUPDATA {
  DD_GETDRIVERINFO2DATA gdi2;
  ULONG_PTR             ulUniqueAdapterGroupId;
  DWORD                 dwReserved1;
  DWORD                 dwReserved2;
} DD_GETADAPTERGROUPDATA;

Membros

gdi2

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

ulUniqueAdapterGroupId

Recebe o identificador do grupo de adaptadores que compõem o cartão de vídeo de várias cabeças do driver. O driver deve fornecer um identificador exclusivo para o master e todos os adaptadores subordinados dentro desse grupo.

dwReserved1

Especifica um campo reservado. O driver não deve ler ou gravar. Defina como zero.

dwReserved2

Especifica um campo reservado. O driver não deve ler ou gravar. Defina como zero.

Comentários

O runtime usa DD_GETADAPTERGROUPDATA em uma consulta para a identidade do grupo de adaptadores do driver. Esse grupo compartilha hardware de vídeo como memória de vídeo e o acelerador 3D. O runtime usa principalmente essa consulta para adaptadores de vídeo de exibição dupla. Um aplicativo pode solicitar que os recursos de superfície (como texturas e buffers de vértice) sejam compartilhados entre adaptadores em um grupo e o runtime esteja em conformidade com essa solicitação.

O identificador em ulUniqueAdapterGroupId deve ser exclusivo entre drivers, incluindo drivers de outros fornecedores de hardware. Portanto, é recomendável relatar esse identificador como um endereço exclusivo no modo kernel que não pode ser comum com outras placas de vídeo com vários cabeçalhos. Observe que o driver deve relatar esse identificador como diferente de zero.

Requisitos

Requisito	Valor
Cabeçalho	d3dhal.h (inclua D3dhal.h)

Confira também

DD_GETDRIVERINFO2DATA

DD_GETDRIVERINFODATA