Fonction SetupDiGetHwProfileList (setupapi.h)
La fonction SetupDiGetHwProfileList récupère une liste de tous les ID de profil matériel actuellement définis.
Syntaxe
WINSETUPAPI BOOL SetupDiGetHwProfileList(
[out] PDWORD HwProfileList,
[in] DWORD HwProfileListSize,
[out] PDWORD RequiredSize,
[out, optional] PDWORD CurrentlyActiveIndex
);
Paramètres
[out] HwProfileList
Pointeur vers un tableau pour recevoir la liste des ID de profil matériel actuellement définis.
[in] HwProfileListSize
Nombre de DWORD dans la mémoire tampon HwProfileList .
[out] RequiredSize
Pointeur vers une variable de type DWORD qui reçoit le nombre de profils matériels actuellement définis. Si le nombre est supérieur à HwProfileListSize, la liste est tronquée pour s’adapter à la taille du tableau. La valeur retournée dans RequiredSize indique la taille du tableau nécessaire pour stocker l’ensemble de la liste des profils matériels. Dans ce cas, la fonction échoue et un appel à GetLastError retourne ERROR_INSUFFICIENT_BUFFER.
[out, optional] CurrentlyActiveIndex
Pointeur vers une variable de type DWORD qui reçoit l’index du profil matériel actuellement actif dans la liste des profils matériels récupérés. Ce paramètre est facultatif et peut être NULL.
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
Appelez SetupDiGetHwProfileListEx pour récupérer les ID de profil matériel d’un ordinateur distant.
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 |
| DLL | Setupapi.dll |