estrutura SP_DRVINFO_DATA_V1_A (setupapi.h)

Artigo
08/26/2023

Uma estrutura SP_DRVINFO_DATA contém informações sobre um driver. Essa estrutura é um membro de uma lista de informações de driver que pode ser associada a uma instância de dispositivo específica ou globalmente a um conjunto de informações do dispositivo.

Sintaxe

typedef struct _SP_DRVINFO_DATA_V1_A {
  DWORD     cbSize;
  DWORD     DriverType;
  ULONG_PTR Reserved;
  CHAR      Description[LINE_LEN];
  CHAR      MfgName[LINE_LEN];
  CHAR      ProviderName[LINE_LEN];
} SP_DRVINFO_DATA_V1_A, *PSP_DRVINFO_DATA_V1_A;

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. Apenas 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.

Comentários

Em SetupAPI.h, essa estrutura equivale a SP_DRVINFO_DATA_V1 ou SP_DRVINFO_DATA_V2, com base em incluir 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 .

As funções SetupDiXxx 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 membro cbSize 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.

Observação

O cabeçalho setupapi.h define SP_DRVINFO_DATA_V1 como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.