Fonction SetupDiCreateDeviceInfoList (setupapi.h)
La fonction SetupDiCreateDeviceInfoList crée un jeu d’informations d’appareil vide et associe éventuellement l’ensemble à une classe d’installation d’appareil et à une fenêtre de niveau supérieur.
Syntaxe
WINSETUPAPI HDEVINFO SetupDiCreateDeviceInfoList(
[in, optional] const GUID *ClassGuid,
[in, optional] HWND hwndParent
);
Paramètres
[in, optional] ClassGuid
Pointeur vers le GUID de la classe d’installation de l’appareil à associer au jeu d’informations d’appareil nouvellement créé. Si ce paramètre est spécifié, seuls les appareils de cette classe peuvent être inclus dans cet ensemble d’informations d’appareil. Si ce paramètre a la valeur NULL, le jeu d’informations sur l’appareil n’est pas associé à une classe d’installation d’appareil spécifique.
[in, optional] hwndParent
Handle de la fenêtre de niveau supérieur à utiliser pour toute interface utilisateur liée à des actions non spécifiques à l’appareil (par exemple, une boîte de dialogue sélectionner un appareil qui utilise la liste des pilotes de classe globale). Ce handle est facultatif et peut être NULL. Si une fenêtre de niveau supérieur spécifique n’est pas requise, définissez hwndParent surNULL.
Valeur retournée
La fonction retourne un handle à un jeu d’informations d’appareil vide s’il réussit. Sinon, il retourne INVALID_HANDLE_VALUE. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
L’appelant de cette fonction doit supprimer le jeu d’informations d’appareil retourné quand il n’est plus nécessaire en appelant SetupDiDestroyDeviceInfoList.
Pour créer une liste d’informations sur un appareil pour un ordinateur distant, utilisez SetupDiCreateDeviceInfoListEx.
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 |
| Ensemble d’API | ext-ms-win-setupapi-classinstallers-l1-1-1 (introduit dans Windows 8.1) |