SP_DRVINFO_DATA_V1_W struttura (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 driver che può essere associato a un'istanza di dispositivo specifica o a livello globale con un set di informazioni sul dispositivo.

Sintassi

typedef struct _SP_DRVINFO_DATA_V1_W {
  DWORD     cbSize;
  DWORD     DriverType;
  ULONG_PTR Reserved;
  WCHAR     Description[LINE_LEN];
  WCHAR     MfgName[LINE_LEN];
  WCHAR     ProviderName[LINE_LEN];
} SP_DRVINFO_DATA_V1_W, *PSP_DRVINFO_DATA_V1_W;

Members

cbSize

Dimensioni, 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. Questo è in genere il nome dell'organizzazione che crea il driver o il file INF. ProviderName può essere una stringa vuota.

Commenti

In SetupAPI.h questa struttura equivale a SP_DRVINFO_DATA_V1 o SP_DRVINFO_DATA_V2, in base alla presenza della 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 verificare 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.