structure SP_DRVINFO_DATA_V1_A (setupapi.h)

Article
08/26/2023

Une structure SP_DRVINFO_DATA contient des informations sur un pilote. Cette structure est membre d’une liste d’informations sur les pilotes qui peut être associée à un appareil particulier instance ou globalement à un ensemble d’informations d’appareil.

Syntaxe

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;

Membres

cbSize

Taille, en octets, de la structure SP_DRVINFO_DATA. Pour plus d’informations, consultez la section Remarques de cette rubrique.

DriverType

Type de pilote représenté par cette structure. Il doit s’agir de l’une des valeurs suivantes :

SPDIT_CLASSDRIVER

Cette structure représente un pilote de classe.

SPDIT_COMPATDRIVER

Cette structure représente un pilote compatible.

Reserved

Réservé. À usage interne uniquement.

Description[LINE_LEN]

Chaîne terminée par NULL qui décrit l’appareil pris en charge par ce pilote.

MfgName[LINE_LEN]

Chaîne terminée par NULL qui contient le nom du fabricant de l’appareil pris en charge par ce pilote.

ProviderName[LINE_LEN]

Chaîne terminée par NULL qui donne le fournisseur de ce pilote. Il s’agit généralement du nom du organization qui crée le pilote ou le fichier INF. ProviderName peut être une chaîne vide.

Remarques

Dans SetupAPI.h, cette structure équivaut à SP_DRVINFO_DATA_V1 ou SP_DRVINFO_DATA_V2, selon que vous incluez la ligne suivante dans votre code source :

#define  USE_SP_DRVINFO_DATA_V1 1

Définissez cet identificateur uniquement si votre composant doit s’exécuter sur Windows 98 ou Millennium Edition, ou sur Windows NT. Si votre composant est exécuté uniquement dans Windows 2000 et versions ultérieures de Windows, ne définissez pas l’identificateur. Si l’identificateur n’est pas défini, SP_DRVINFO_DATA_V2 est utilisé.

SP_DRVINFO_DATA_V1 ne contient pas de membres DriverDate et DriverVersion .

Les fonctions SetupDiXxx qui prennent une structure SP_DRVINFO_DATA en tant que paramètre vérifient que le membre cbSize de la structure fournie est égal à la taille, en octets, de la structure. Si le membre cbSize n’est pas défini correctement pour un paramètre d’entrée, la fonction échoue et définit un code d’erreur de ERROR_INVALID_PARAMETER. Si le membre cbSize n’est pas défini correctement pour un paramètre de sortie, la fonction échoue et définit un code d’erreur de ERROR_INVALID_USER_BUFFER.

Notes

L’en-tête setupapi.h définit SP_DRVINFO_DATA_V1 comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.