estrutura D3DADAPTER_IDENTIFIER9

  • Artigo

Contém informações que identificam o adaptador.

Sintaxe

typedef struct D3DADAPTER_IDENTIFIER9 {
  char          Driver[MAX_DEVICE_IDENTIFIER_STRING];
  char          Description[MAX_DEVICE_IDENTIFIER_STRING];
  char          DeviceName[32];
#ifdef _WIN32
  LARGE_INTEGER DriverVersion;
#else
  DWORD         DriverVersionLowPart;
  DWORD         DriverVersionHighPart;
#endif
  DWORD         VendorId;
  DWORD         DeviceId;
  DWORD         SubSysId;
  DWORD         Revision;
  GUID          DeviceIdentifier;
  DWORD         WHQLLevel;
} D3DADAPTER_IDENTIFIER9, *LPD3DADAPTER_IDENTIFIER9;

Membros

Driver

Tipo: char

Usado para apresentação para o usuário. Isso não deve ser usado para identificar drivers específicos, pois muitas cadeias de caracteres diferentes podem estar associadas ao mesmo dispositivo e driver de diferentes fornecedores.

Descrição

Tipo: char

Usado para apresentação para o usuário.

DeviceName

Tipo: char

Nome do dispositivo para GDI.

DriverVersion

Tipo: LARGE_INTEGER

Identifique a versão do driver Direct3D. É legal fazer menos do que comparações com o valor inteiro com sinal de 64 bits. No entanto, tenha cuidado se você usar esse elemento para identificar drivers problemáticos. Em vez disso, você deve usar DeviceIdentifier. Consulte Observações.

DriverVersionLowPart

Tipo: DWORD

Identifique a versão do driver Direct3D. É legal fazer < e > comparações sobre o valor inteiro com sinal de 64 bits. No entanto, tenha cuidado se você usar esse elemento para identificar drivers problemáticos. Em vez disso, você deve usar DeviceIdentifier. Consulte Observações.

DriverVersionHighPart

Tipo: DWORD

Identifique a versão do driver Direct3D. É legal fazer < e > comparações sobre o valor inteiro com sinal de 64 bits. No entanto, tenha cuidado se você usar esse elemento para identificar drivers problemáticos. Em vez disso, você deve usar DeviceIdentifier. Consulte Observações.

Vendorid

Tipo: DWORD

Pode ser usado para ajudar a identificar um conjunto de chips específico. Consulte esse membro para identificar o fabricante. O valor pode ser zero se desconhecido.

DeviceId

Tipo: DWORD

Pode ser usado para ajudar a identificar um conjunto de chips específico. Consulte esse membro para identificar o tipo de conjunto de chips. O valor pode ser zero se desconhecido.

SubSysId

Tipo: DWORD

Pode ser usado para ajudar a identificar um conjunto de chips específico. Consulte esse membro para identificar o subsistema, normalmente o quadro específico. O valor pode ser zero se desconhecido.

Revisão

Tipo: DWORD

Pode ser usado para ajudar a identificar um conjunto de chips específico. Consulte esse membro para identificar o nível de revisão do conjunto de chips. O valor pode ser zero se desconhecido.

DeviceIdentifier

Tipo: GUID

Pode ser consultado para marcar alterações no conjunto de drivers e chips. Esse GUID é um identificador exclusivo para o par driver e conjunto de chips. Consulte esse membro para controlar as alterações no driver e no conjunto de chips para gerar um novo perfil para o subsistema gráfico. DeviceIdentifier também pode ser usado para identificar drivers problemáticos específicos.

WHQLLevel

Tipo: DWORD

Usado para determinar o nível de validação do WHQL (Hardware Quality Labs) do Windows para esse par de driver e dispositivo. O DWORD é uma estrutura de datas empacotada que define a data do lançamento do teste WHQL mais recente passado pelo driver. É legal executar < operações e > nesse valor. O seguinte ilustra o formato de data.

Bits Descrição
31-16 No ano, um número decimal de 1999 para cima.
15-8 O mês, um número decimal de 1 a 12.
7-0 O dia, um número decimal de 1 a 31.

 

Os valores a seguir também são usados.

Valor Descrição
0 Não certificado.
1 WHQL validado, mas nenhuma informação de data está disponível.

 

Diferenças entre Direct3D 9 e Direct3D 9Ex:

Para Direct3D9Ex em execução no Windows Vista, Windows Server 2008, Windows 7 e Windows Server 2008 R2 (ou sistema operacional mais atual), IDirect3D9::GetAdapterIdentifier retorna 1 para o nível WHQL sem verificar o status do driver.

Comentários

O exemplo de pseudocódigo a seguir ilustra o formato de versão codificado nos membros DriverVersion, DriverVersionLowPart e DriverVersionHighPart.

Product = HIWORD(DriverVersion.HighPart)
Version = LOWORD(DriverVersion.HighPart)
SubVersion = HIWORD(DriverVersion.LowPart)
Build = LOWORD(DriverVersion.LowPart)

Consulte o SDK da Plataforma para obter mais informações sobre a macro HIWORD, a macro LOWORD e a estrutura LARGE_INTEGER.

MAX_DEVICE_IDENTIFIER_STRING é uma constante com a definição a seguir.

#define MAX_DEVICE_IDENTIFIER_STRING        512

Os membros VendorId, DeviceId, SubSysId e Revision podem ser usados em conjunto para identificar conjuntos de chips específicos. No entanto, use esses membros com cuidado.

Requisitos

Requisito Valor
parâmetro
D3D9Types.h

Confira também

Estruturas Direct3D