Compartilhar via


estrutura DD_GETADAPTERGROUPDATA (d3dhal.h)

Somente versões posteriores e DirectX 9.0.

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 de DD_GETDRIVERINFO2DATA que contém os dados de GetDriverInfo2 para a consulta.

ulUniqueAdapterGroupId

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

dwReserved1

Especifica um campo reservado. O driver não deve ler nem gravar. Definido como zero.

dwReserved2

Especifica um campo reservado. O driver não deve ler nem gravar. Definido como zero.

Observações

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 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 de várias cabeças. Observe que o driver deve relatar esse identificador como diferente de zero.

Requisitos

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

Consulte também

DD_GETDRIVERINFO2DATA

DD_GETDRIVERINFODATA