SetupDiOpenDeviceInfoA, fonction (setupapi.h)

La fonction SetupDiOpenDeviceInfo ajoute un élément d’informations d’appareil pour une instance d’appareil à un jeu d’informations sur l’appareil, s’il n’existe pas déjà dans le jeu d’informations sur l’appareil et récupère les informations qui identifient l’élément d’informations de l’appareil pour l’instance de l’appareil dans le jeu d’informations sur l’appareil.

Syntaxe

WINSETUPAPI BOOL SetupDiOpenDeviceInfoA(
  [in]            HDEVINFO         DeviceInfoSet,
  [in]            PCSTR            DeviceInstanceId,
  [in, optional]  HWND             hwndParent,
  [in]            DWORD            OpenFlags,
  [out, optional] PSP_DEVINFO_DATA DeviceInfoData
);

Paramètres

[in] DeviceInfoSet

Un handle du jeu d’informations d’appareil auquel SetupDiOpenDeviceInfo ajoute un élément d’informations sur l’appareil, s’il n’existe pas déjà, pour l’instance d’appareil spécifiée par DeviceInstanceId.

[in] DeviceInstanceId

Pointeur vers une chaîne terminée par NULL qui fournit l’identificateur d’instance d’appareil d’un appareil (par exemple, « Root*PNP0500\0000 »). Si DeviceInstanceId est NULL ou fait référence à une chaîne de longueur nulle, SetupDiOpenDeviceInfo ajoute un élément d’informations d’appareil au jeu d’informations d’appareil fourni, s’il n’existe pas déjà, pour l’appareil racine dans l’arborescence de l’appareil.

[in, optional] hwndParent

Handle vers la fenêtre de niveau supérieur à utiliser pour toute interface utilisateur liée à l’installation de l’appareil.

[in] OpenFlags

Variable de type DWORD qui contrôle l’ouverture de l’élément d’informations d’appareil. La valeur de ce paramètre peut être une ou plusieurs des suivantes :

DIOD_CANCEL_REMOVE

Si cet indicateur est spécifié et que l’appareil a été marqué pour la suppression en attente, le système d’exploitation annule la suppression en attente.

DIOD_INHERIT_CLASSDRVS

Si cet indicateur est spécifié, l’élément d’informations sur l’appareil résultant hérite de la liste des pilotes de classe, le cas échéant, associé au jeu d’informations sur l’appareil. En outre, s’il existe un pilote sélectionné pour le jeu d’informations sur l’appareil, ce même pilote est sélectionné pour le nouvel élément d’informations sur l’appareil.

Si l’élément d’informations sur l’appareil était déjà présent, sa liste de pilotes de classe, le cas échéant, est remplacée par la liste héritée.

[out, optional] DeviceInfoData

Pointeur vers une structure SP_DEVINFO_DATA fournie par l’appelant qui reçoit des informations sur l’élément d’informations d’appareil pour l’instance d’appareil spécifiée par DeviceInstanceId. L’appelant doit définir cbSize sur sizeof(SP_DEVINFO_DATA). Ce paramètre est facultatif et peut être NULL.

Valeur de retour

SetupDiOpenDeviceInfo retourne TRUE si elle réussit. Sinon, la fonction retourne FALSE et l’erreur journalisée peut être récupérée avec un appel à GetLastError.

Remarques

Si cette instance d’appareil est ajoutée à un jeu qui a une classe associée, la classe d’appareil doit être identique ou l’appel échoue. Dans ce cas, un appel à GetLastError retourne ERROR_CLASS_MISMATCH.

Si le nouvel élément d’informations sur l’appareil est correctement ouvert, mais que l’appelant DeviceInfoData tampon n’est pas valide, cette fonction retourne FALSE. Dans ce cas, un appel à GetLastError retourne ERROR_INVALID_USER_BUFFER. Toutefois, l’élément d’informations sur l’appareil est ajouté en tant que nouveau membre de l’ensemble.

Exigences

Voir aussi

SP_DEVINFO_DATA

SetupDiCreateDeviceInfo

SetupDiDeleteDeviceInfo

SetupDiEnumDeviceInfo