SetupDiGetDeviceInstanceIdA, fonction (setupapi.h)
La fonction SetupDiGetDeviceInstanceId récupère l’ID d’instance d’appareil associé à un élément d’informations sur l’appareil.
Note
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 d’instance de l’appareil. Consultez récupération d’un identificateur d’instance d’appareil pour plus d’informations.
Syntaxe
WINSETUPAPI BOOL SetupDiGetDeviceInstanceIdA(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVINFO_DATA DeviceInfoData,
[out, optional] PSTR DeviceInstanceId,
[in] DWORD DeviceInstanceIdSize,
[out, optional] PDWORD RequiredSize
);
Paramètres
[in] DeviceInfoSet
Handle de l’ensemble d’informations de l’appareil qui contient l’élément d’informations sur l’appareil qui représente l’appareil pour lequel récupérer un ID d’instance d’appareil.
[in] DeviceInfoData
Pointeur vers une structure SP_DEVINFO_DATA qui spécifie l’élément d’informations d’appareil dans DeviceInfoSet.
[out, optional] DeviceInstanceId
Pointeur vers la mémoire tampon de caractères qui recevra l’ID d’instance d’appareil arrêté null pour l’élément d’informations d’appareil spécifié. Pour plus d’informations sur les ID d’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 d’instance de l’appareil.
Valeur de retour
La fonction retourne TRUE si elle réussit. Sinon, elle retourne FAUX et l’erreur journalisée peut être récupérée en effectuant un appel à GetLastError.
Remarques
Note
L’en-tête setupapi.h définit SetupDiGetDeviceInstanceId comme 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows. |
| plateforme cible | Bureau |
| d’en-tête | setupapi.h (include Setupapi.h) |
| bibliothèque | Setupapi.lib |