Partager via

Fonction SetupDiCreateDeviceInfoList (setupapi.h)

  • Article

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)

Voir aussi

SetupDiCreateDeviceInfoListEx

SetupDiDestroyDeviceInfoList

SetupDiGetClassDevs

SetupDiGetDeviceInfoListClass