SetupDiSelectOEMDrv, fonction (setupapi.h)
La fonction SetupDiSelectOEMDrv sélectionne un pilote pour un jeu d’informations d’appareil ou un élément d’informations d’appareil particulier qui utilise un chemin d’accès OEM fourni par l’utilisateur.
Syntaxe
WINSETUPAPI BOOL SetupDiSelectOEMDrv(
[in, optional] HWND hwndParent,
[in] HDEVINFO DeviceInfoSet,
[in, out] PSP_DEVINFO_DATA DeviceInfoData
);
Paramètres
[in, optional] hwndParent
Handle de fenêtre qui sera le parent de toutes les boîtes de dialogue créées pendant le traitement de cette fonction. Ce paramètre peut être utilisé pour remplacer le champ hwndParent dans le bloc de paramètres d’installation de l’élément ou du jeu d’informations d’appareil spécifié.
[in] DeviceInfoSet
Handle du jeu d’informations sur l’appareil pour lequel sélectionner un pilote.
[in, out] DeviceInfoData
Pointeur vers une structure SP_DEVINFO_DATA qui spécifie un é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é, SetupDiSelectOEMDrv associe le pilote sélectionné à l’appareil spécifié. Si ce paramètre a la valeur NULL, SetupDiSelectOEMDrv associe le pilote sélectionné à 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
SetupDiSelectOEMDrv est principalement conçu pour sélectionner un pilote OEM pour un appareil sur un ordinateur local avant d’installer l’appareil sur cet ordinateur. Bien que SetupDiSelectOEMDrv n’échoue pas si l’ensemble d’informations de 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.
SetupDiSelectOEMDrv invite l’utilisateur à entrer le chemin OEM, puis appelle le programme d’installation de la classe pour sélectionner un pilote à partir du chemin OEM.
Configuration requise
| Client minimal pris en charge | Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows. |
| Plateforme cible | Bureau |
| En-tête | setupapi.h (inclure Setupapi.h) |
| Bibliothèque | Setupapi.lib |
| DLL | Setupapi.dll |