Fonction SetupDiSetSelectedDriverA (setupapi.h)

Article
03/01/2024

La fonction SetupDiSetSelectedDriver définit ou réinitialise le pilote sélectionné pour un élément d’informations sur l’appareil ou le pilote de classe sélectionné pour un jeu d’informations de périphérique.

Syntaxe

WINSETUPAPI BOOL SetupDiSetSelectedDriverA(
  [in]      HDEVINFO           DeviceInfoSet,
  [in, out] PSP_DEVINFO_DATA   DeviceInfoData,
  [in, out] PSP_DRVINFO_DATA_A DriverInfoData
);

Paramètres

[in] DeviceInfoSet

Handle du jeu d’informations sur l’appareil qui contient la liste des pilotes à partir de laquelle sélectionner un pilote pour un élément d’informations sur l’appareil ou pour le jeu d’informations sur l’appareil.

[in, out] DeviceInfoData

Pointeur vers une structure de SP_DEVINFO_DATA qui spécifie l’élément d’informations sur l’appareil dans DeviceInfoSet. Ce paramètre est facultatif et peut être NULL. Si ce paramètre est spécifié, SetupDiSetSelectedDriver définit ou réinitialise le pilote sélectionné pour l’appareil spécifié. Si ce paramètre a la valeur NULL, SetupDiSetSelectedDriver définit ou réinitialise le pilote de classe sélectionné pour DeviceInfoSet.

[in, out] DriverInfoData

Pointeur vers une structure de SP_DRVINFO_DATA qui spécifie le pilote à sélectionner. Ce paramètre est facultatif et peut être NULL. Si ce paramètre et DeviceInfoData sont fournis, le pilote spécifié doit être membre d’une liste de pilotes associée à DeviceInfoData. Si ce paramètre est spécifié et que DeviceInfoData a la valeur NULL, le pilote doit être membre de la liste des pilotes de classe globale pour DeviceInfoSet. Si ce paramètre a la valeur NULL, le pilote sélectionné est réinitialisé pour l’élément d’informations sur l’appareil, si DeviceInfoData est spécifié, ou le jeu d’informations sur l’appareil, si DeviceInfoData a la valeur NULL.

Si driverInfoData.Réservé est NULL, l’appelant demande une recherche pour un nœud de pilote avec les paramètres spécifiés (DriverType, Description et ProviderName). Si une correspondance est trouvée, ce nœud de pilote est sélectionné. Le champ Réservé est mis à jour sur la sortie pour refléter le nœud de pilote réel où la correspondance a été trouvée. Si une correspondance est introuvable, la fonction échoue et un appel à GetLastError retourne ERROR_INVALID_PARAMETER.

Valeur retournée

La fonction retourne TRUE si elle réussit. Sinon, il retourne FALSE et l’erreur journalisée peut être récupérée avec un appel à GetLastError.

Remarques

Si l’appelant de SetupDiSetSelectedDriver est membre du groupe Administrateurs, la classe de l’appareil est définie sur la classe du pilote sélectionné, à condition que les deux classes soient différentes.

Si DriverInfoData a la valeur NULL, SetupDiSetSelectedDriver réinitialise le pilote sélectionné. Par conséquent, aucun pilote n’est sélectionné.

Notes

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	setupapi.h (inclure Setupapi.h)
Bibliothèque	Setupapi.lib

Voir aussi

SetupDiGetSelectedDriver

Partager via