Compartilhar via

estrutura DDDEVICEIDENTIFIER2 (ddraw.h)

  • Artigo

A estrutura DDDEVICEIDENTIFIER2 é passada para o método IDirectDraw7::GetDeviceIdentifier para obter informações sobre um dispositivo.

Sintaxe

typedef struct tagDDDEVICEIDENTIFIER2 {
  char          szDriver[MAX_DDDEVICEID_STRING];
  char          szDescription[MAX_DDDEVICEID_STRING];
  LARGE_INTEGER liDriverVersion;
  DWORD         dwDriverVersionLowPart;
  DWORD         dwDriverVersionHighPart;
  DWORD         dwVendorId;
  DWORD         dwDeviceId;
  DWORD         dwSubSysId;
  DWORD         dwRevision;
  GUID          guidDeviceIdentifier;
  DWORD         dwWHQLLevel;
} DDDEVICEIDENTIFIER2, *LPDDDEVICEIDENTIFIER2;

Membros

szDriver[MAX_DDDEVICEID_STRING]

Nome do driver.

szDescription[MAX_DDDEVICEID_STRING]

Descrição do driver.

liDriverVersion

Versão do driver. É válido fazer comparações menores e maiores que em todos os 64 bits. Cuidado deve ser exercido se você usar esse elemento para identificar drivers problemáticos; Em vez disso, use o membro guidDeviceIdentifier para essa finalidade.

Os dados assumem a seguinte forma:


wProduct = HIWORD(liDriverVersion.HighPart)
wVersion = LOWORD(liDriverVersion.HighPart)
wSubVersion = HIWORD(liDriverVersion.LowPart)
wBuild = LOWORD(liDriverVersion.LowPart)

dwDriverVersionLowPart

dwDriverVersionHighPart

dwVendorId

Identificador do fabricante. Pode ser 0 se desconhecido.

dwDeviceId

Identificador do tipo de chipset. Pode ser 0 se desconhecido.

dwSubSysId

Identificador do subsistema. Normalmente, isso significa o quadro específico. Pode ser 0 se desconhecido.

dwRevision

Identificador do nível de revisão do chipset. Pode ser 0 se desconhecido.

guidDeviceIdentifier

Identificador exclusivo para o par de drivers e chipset. Use esse valor se quiser controlar as alterações no driver ou no chipset para reprofilar o subsistema gráfico. Ele também pode ser usado para identificar drivers problemáticos específicos.

dwWHQLLevel

O nível de certificação WHQL (Hardware Quality Lab) do Windows para o par de dispositivos e drivers.

Comentários

Os valores em szDriver e szDescription são apenas para apresentação para o usuário. Eles não devem ser usados para identificar drivers específicos porque cadeias de caracteres diferentes podem estar associadas ao mesmo dispositivo ou o mesmo driver de diferentes fornecedores pode ser descrito de forma diferente.

Os membros dwVendorId, dwDeviceId, dwSubSysId e dwRevision podem ser usados para identificar chipsets específicos, mas use extrema cautela.

Requisitos

Requisito Valor
Cabeçalho ddraw.h