struttura SP_DRVINFO_DATA_V1_A (setupapi.h)

Articolo
11/20/2024

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_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;

Membri

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 che contiene il nome del produttore del dispositivo supportato da questo driver.

ProviderName[LINE_LEN]

Stringa con terminazione NULL che fornisce al 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.

Osservazioni

In SetupAPI.h, questa struttura equivale a SP_DRVINFO_DATA_V1 o SP_DRVINFO_DATA_V2, in base al fatto che nel codice sorgente sia inclusa la riga seguente:

#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 DriverDate e membri 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 imposta 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 imposta un codice di errore di ERROR_INVALID_USER_BUFFER.

Nota

L'intestazione setupapi.h definisce SP_DRVINFO_DATA_V1 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.