Fonction SetupDiGetDeviceInstanceIdW (setupapi.h)

Article
03/06/2024

La fonction SetupDiGetDeviceInstanceId récupère l’ID de instance d’appareil associé à un élément d’informations sur l’appareil.

Notes

Dans Windows Vista et les versions ultérieures de Windows, le modèle de propriété d’appareil unifié utilise la clé de propriété DEVPKEY_Device_InstanceId pour représenter l’identificateur de instance d’appareil. Pour plus d’informations, consultez Récupération d’un identificateur d’instance d’appareil .

Syntaxe

WINSETUPAPI BOOL SetupDiGetDeviceInstanceIdW(
  [in]            HDEVINFO         DeviceInfoSet,
  [in]            PSP_DEVINFO_DATA DeviceInfoData,
  [out, optional] PWSTR            DeviceInstanceId,
  [in]            DWORD            DeviceInstanceIdSize,
  [out, optional] PDWORD           RequiredSize
);

Paramètres

[in] DeviceInfoSet

Handle du jeu d’informations d’appareil qui contient l’élément d’informations sur l’appareil qui représente l’appareil pour lequel récupérer un id de instance d’appareil.

[in] DeviceInfoData

Pointeur vers une structure de SP_DEVINFO_DATA qui spécifie l’élément d’informations sur l’appareil dans DeviceInfoSet.

[out, optional] DeviceInstanceId

Pointeur vers la mémoire tampon de caractères qui recevra l’ID de instance d’appareil terminé par NULL pour l’élément d’informations sur l’appareil spécifié. Pour plus d’informations sur les ID de instance d’appareil, consultez Chaînes d’identification d’appareil.

[in] DeviceInstanceIdSize

Taille, en caractères, de la mémoire tampon DeviceInstanceId .

[out, optional] RequiredSize

Pointeur vers la variable qui reçoit le nombre de caractères requis pour stocker l’ID de instance de l’appareil.

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

Remarques

Notes

L’en-tête setupapi.h définit SetupDiGetDeviceInstanceId comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

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

Voir aussi

SP_DEVINFO_DATA

SetupDiCreateDevRegKey

SetupDiCreateDeviceInfo

SetupDiOpenDevRegKey

SetupDiOpenDeviceInfo

Partager via