structure SP_DRVINFO_DATA_V1_A (setupapi.h)

Article
11/20/2024

Une structure SP_DRVINFO_DATA contient des informations sur un pilote. Cette structure est membre d’une liste d’informations de pilote qui peut être associée à une instance d’appareil particulière ou globalement à un jeu 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. Doit être 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é. Pour une utilisation 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 donnant au fournisseur de ce pilote. Il s’agit généralement du nom de l’organisation qui crée le fichier pilote ou 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 les 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.

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 cbSize membre 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 cbSize membre 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.

Note

L’en-tête setupapi.h définit SP_DRVINFO_DATA_V1 en tant qu’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.