estrutura SP_DRVINFO_DATA_V2_W (setupapi.h)
Uma estrutura SP_DRVINFO_DATA contém informações sobre um driver. Essa estrutura é um membro de uma lista de informações do driver que pode ser associada a uma instância de dispositivo específica ou globalmente com um conjunto de informações do dispositivo.
Sintaxe
typedef struct _SP_DRVINFO_DATA_V2_W {
DWORD cbSize;
DWORD DriverType;
ULONG_PTR Reserved;
WCHAR Description[LINE_LEN];
WCHAR MfgName[LINE_LEN];
WCHAR ProviderName[LINE_LEN];
FILETIME DriverDate;
DWORDLONG DriverVersion;
} SP_DRVINFO_DATA_V2_W, *PSP_DRVINFO_DATA_V2_W;
Membros
cbSize
O tamanho, em bytes, da estrutura SP_DRVINFO_DATA. Para obter mais informações, consulte a seção Comentários neste tópico.
DriverType
O tipo de driver representado por essa estrutura. Deve ser um dos seguintes valores:
SPDIT_CLASSDRIVER
Essa estrutura representa um driver de classe.
SPDIT_COMPATDRIVER
Essa estrutura representa um driver compatível.
Reserved
Reservado. Somente para uso interno.
Description[LINE_LEN]
Uma cadeia de caracteres terminada em NULL que descreve o dispositivo compatível com esse driver.
MfgName[LINE_LEN]
Uma cadeia de caracteres terminada em NULL que contém o nome do fabricante do dispositivo compatível com esse driver.
ProviderName[LINE_LEN]
Uma cadeia de caracteres terminada em NULL que dá ao provedor desse driver. Normalmente, esse é o nome da organização que cria o driver ou o arquivo INF. ProviderName pode ser uma cadeia de caracteres vazia.
DriverDate
Data do driver. Na entrada DriverVer no arquivo INF. Consulte a seção
DriverVersion
Versão do driver. Na entrada DriverVer no arquivo INF.
Observações
Em SetupAPI.h, essa estrutura equivale a SP_DRVINFO_DATA_V1 ou SP_DRVINFO_DATA_V2, com base em se você inclui a seguinte linha no código-fonte:
#define USE_SP_DRVINFO_DATA_V1 1
Defina esse identificador somente se o componente precisar ser executado no Windows 98 ou Millennium Edition ou no Windows NT. Se o componente for executado somente no Windows 2000 e versões posteriores do Windows, não defina o identificador. Se o identificador não estiver definido, SP_DRVINFO_DATA_V2 será usado.
SP_DRVINFO_DATA_V1 não contém membros DriverDate e DriverVersion.
SetupDixxx funções que tomam uma estrutura SP_DRVINFO_DATA como parâmetro verificam se o membro cbSize da estrutura fornecida é igual ao tamanho, em bytes, da estrutura. Se o membro cbSize não estiver definido corretamente para um parâmetro de entrada, a função falhará e definirá um código de erro de ERROR_INVALID_PARAMETER. Se o cbSize membro não estiver definido corretamente para um parâmetro de saída, a função falhará e definirá um código de erro de ERROR_INVALID_USER_BUFFER.
Nota
O cabeçalho setupapi.h define SP_DRVINFO_DATA_V2 como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | setupapi.h (inclua Setupapi.h) |
Consulte também
setupDiGetSelectedDriver