struttura SP_DRVINFO_DATA_V2_A (setupapi.h)

Articolo
08/26/2023

Una struttura SP_DRVINFO_DATA contiene informazioni su un driver. Questa struttura è un membro di un elenco di informazioni sui driver che può essere associato a una particolare istanza del dispositivo o a livello globale con un set di informazioni sul dispositivo.

Sintassi

typedef struct _SP_DRVINFO_DATA_V2_A {
  DWORD     cbSize;
  DWORD     DriverType;
  ULONG_PTR Reserved;
  CHAR      Description[LINE_LEN];
  CHAR      MfgName[LINE_LEN];
  CHAR      ProviderName[LINE_LEN];
  FILETIME  DriverDate;
  DWORDLONG DriverVersion;
} SP_DRVINFO_DATA_V2_A, *PSP_DRVINFO_DATA_V2_A;

Members

cbSize

Dimensione, in byte, della struttura SP_DRVINFO_DATA. Per altre informazioni, vedere la sezione Osservazioni in questo argomento.

DriverType

Tipo di driver rappresentato da questa struttura. Deve essere uno dei valori seguenti:

SPDIT_CLASSDRIVER

Questa struttura rappresenta un driver di classe.

SPDIT_COMPATDRIVER

Questa struttura rappresenta un driver compatibile.

Reserved

Riservato. Solo per uso interno.

Description[LINE_LEN]

Stringa con terminazione NULL che descrive il dispositivo supportato da questo driver.

MfgName[LINE_LEN]

Stringa con terminazione NULL contenente il nome del produttore del dispositivo supportato da questo driver.

ProviderName[LINE_LEN]

Stringa con terminazione NULL che fornisce il provider di questo driver. Si tratta in genere del nome dell'organizzazione che crea il driver o il file INF. ProviderName può essere una stringa vuota.

DriverDate

Data del conducente. Dalla voce DriverVer nel file INF. Per altre informazioni sulla voce DriverVer, vedere la sezione INF DDInstall.

DriverVersion

Versione del driver. Dalla voce DriverVer nel file INF.

Commenti

In SetupAPI.h questa struttura equivale a SP_DRVINFO_DATA_V1 o SP_DRVINFO_DATA_V2, a seconda che si includa la riga seguente nel codice sorgente:

#define  USE_SP_DRVINFO_DATA_V1 1

Definire questo identificatore solo se il componente deve essere eseguito in Windows 98 o Millennium Edition o in Windows NT. Se il componente viene eseguito solo in Windows 2000 e versioni successive di Windows, non definire l'identificatore. Se l'identificatore non è definito, viene usato SP_DRVINFO_DATA_V2.

SP_DRVINFO_DATA_V1 non contiene membri DriverDate e DriverVersion .

Le funzioni SetupDiXxx che accettano una struttura SP_DRVINFO_DATA come parametro verificano che il membro cbSize della struttura fornita sia uguale alle dimensioni, in byte, della struttura. Se il membro cbSize non è impostato correttamente per un parametro di input, la funzione avrà esito negativo e imposterà un codice di errore di ERROR_INVALID_PARAMETER. Se il membro cbSize non è impostato correttamente per un parametro di output, la funzione avrà esito negativo e imposterà un codice di errore di ERROR_INVALID_USER_BUFFER.

Nota

L'intestazione setupapi.h definisce SP_DRVINFO_DATA_V2 come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.