SetupDiSetSelectedDriverW, fonction (setupapi.h)
Le SetupDiSetSelectedDriver jeux de fonctions, 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 sur l’appareil.
Syntaxe
WINSETUPAPI BOOL SetupDiSetSelectedDriverW(
[in] HDEVINFO DeviceInfoSet,
[in, out] PSP_DEVINFO_DATA DeviceInfoData,
[in, out] PSP_DRVINFO_DATA_W DriverInfoData
);
Paramètres
[in] DeviceInfoSet
Handle du jeu d’informations d’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 SP_DEVINFO_DATA qui spécifie l’élément d’informations d’appareil dans DeviceInfoSet. Ce paramètre est facultatif et peut être NULL. Si ce paramètre est spécifié, SetupDiSetSelectedDriver jeux ou réinitialise, le pilote sélectionné pour l’appareil spécifié. Si ce paramètre est NULL, SetupDiSetSelectedDriver jeux ou réinitialise, le pilote de classe sélectionné pour DeviceInfoSet.
[in, out] DriverInfoData
Pointeur vers une structure 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 DeviceInfoData est NULL, le pilote doit être membre de la liste des pilotes de classe globale pour DeviceInfoSet. Si ce paramètre est NULL, le pilote sélectionné est réinitialisé pour l’élément d’informations sur l’appareil, si DeviceInfoData est spécifié ou si les informations de l’appareil sont définies, si DeviceInfoData est NULL.
Si le DriverInfoData. réservée est NULL, l’appelant demande une recherche d’un nœud de pilote avec les paramètres spécifiés (DriverType, Descriptionet 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 de retour
La fonction retourne TRUE si elle réussit. Sinon, elle retourne FAUX 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 est NULL, SetupDiSetSelectedDriver réinitialise le pilote sélectionné. Par conséquent, il n’existe aucun pilote sélectionné.
Note
L’en-tête setupapi.h définit SetupDiSetSelectedDriver comme 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows. |
| plateforme cible | Bureau |
| d’en-tête | setupapi.h (include Setupapi.h) |
| bibliothèque | Setupapi.lib |