SetupDiSelectDevice, fonction (setupapi.h)

La fonction SetupDiSelectDevice est le gestionnaire par défaut de la demande DIF_SELECTDEVICE .

Syntaxe

WINSETUPAPI BOOL SetupDiSelectDevice(
  [in]      HDEVINFO         DeviceInfoSet,
  [in, out] PSP_DEVINFO_DATA DeviceInfoData
);

Paramètres

[in] DeviceInfoSet

Handle d’un jeu d’informations d’appareil qui contient un élément d’informations sur l’appareil qui représente l’appareil pour lequel sélectionner un pilote.

[in, out] DeviceInfoData

Pointeur vers une structure SP_DEVINFO_DATA qui spécifie l’élément d’informations sur l’appareil. Ce paramètre est facultatif et peut être NULL. Si ce paramètre est spécifié, SetupDiSelectDevice sélectionne le pilote pour l’appareil spécifié et définit DeviceInfoData.ClassGuid vers le GUID de la classe d’installation de l’appareil pour le pilote sélectionné. Si ce paramètre a la valeur NULL, SetupDiSelectDevice définit le pilote sélectionné dans la liste des pilotes de classe globale pour DeviceInfoSet.

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 par un appel à GetLastError.

Remarques

SetupDiSelectDevice gère l’interface utilisateur qui permet à l’utilisateur de sélectionner un pilote pour l’appareil spécifié, ou un ensemble d’informations d’appareil si un appareil n’est pas spécifié. En définissant le champ Indicateurs de la structure SP_DEVINSTALL_PARAMS pour l’appareil, ou les informations sur l’appareil définies si un appareil n’est pas spécifié, l’appelant peut spécifier une gestion spéciale de l’interface utilisateur, par exemple, pour permettre aux utilisateurs de sélectionner un pilote à partir d’un disque d’installation OEM.

Note Seul un programme d’installation de classe doit appeler SetupDiSelectDevice et uniquement dans les situations où le programme d’installation de classe doit effectuer des opérations de sélection de pilotes après que SetupDiSelectDevice a terminé l’opération de sélection de pilote par défaut. Dans de telles situations, le programme d’installation de classe doit appeler directement SetupDiSelectDevice lorsque le programme d’installation traite une demande de DIF_SELECTDEVICE. Pour plus d’informations sur l’appel du gestionnaire par défaut, consultez Appel de gestionnaires de code DIF par défaut.

 

SetupDiSelectDevice est principalement conçu pour sélectionner un pilote pour un appareil sur un ordinateur local avant d’installer l’appareil. Bien que SetupDiSelectDevice n’échoue pas si l’ensemble d’informations sur l’appareil est destiné à un ordinateur distant, le résultat est d’une utilisation limitée, car le jeu d’informations sur l’appareil ne peut pas être utilisé ultérieurement avec DIF_Xxx demandes d’installation ou les fonctions SetupDiXxx qui ne prennent pas en charge les opérations sur un ordinateur distant. En particulier, l’ensemble d’informations sur l’appareil ne peut pas être utilisé comme entrée avec une demande d’installation DIF_INSTALLDEVICE pour installer un appareil sur un ordinateur distant.

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
DLL	Setupapi.dll

Voir aussi

SP_DEVINSTALL_PARAMS

SetupDiCallClassInstaller