estrutura D3DADAPTER_IDENTIFIER9
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 |
|
Confira também