SetupDiGetDriverInfoDetailW, fonction (setupapi.h)
La fonction SetupDiGetDriverInfoDetail récupère les détails des informations du pilote pour un jeu d’informations sur l’appareil ou un élément d’informations d’appareil particulier dans le jeu d’informations sur l’appareil.
Syntaxe
WINSETUPAPI BOOL SetupDiGetDriverInfoDetailW(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[in] PSP_DRVINFO_DATA_W DriverInfoData,
[in, out] PSP_DRVINFO_DETAIL_DATA_W DriverInfoDetailData,
[in] DWORD DriverInfoDetailDataSize,
[out, optional] PDWORD RequiredSize
);
Paramètres
[in] DeviceInfoSet
Handle vers un jeu d’informations de périphérique qui contient un élément d’informations de pilote pour lequel récupérer les informations du pilote.
[in, optional] DeviceInfoData
Pointeur vers une structure SP_DEVINFO_DATA qui spécifie un élément d’informations d’appareil qui représente l’appareil pour lequel récupérer les informations du pilote. Ce paramètre est facultatif et peut être NULL. Si ce paramètre est spécifié, SetupDiGetDriverInfoDetail récupère des informations sur un pilote dans une liste de pilotes pour l’appareil spécifié. Si ce paramètre est NULL, SetupDiGetDriverInfoDetail récupère des informations sur un pilote membre de la liste des pilotes de classe globale pour DeviceInfoSet.
[in] DriverInfoData
Pointeur vers une structure SP_DRVINFO_DATA qui spécifie l’élément d’informations du pilote qui représente le pilote pour lequel récupérer les détails. Si deviceInfoData est spécifié, le pilote doit être membre de la liste des pilotes pour l’appareil spécifié par DeviceInfoData. Sinon, le pilote doit être membre de la liste des pilotes de classe globale pour DeviceInfoSet.
[in, out] DriverInfoDetailData
Pointeur vers une structure SP_DRVINFO_DETAIL_DATA qui reçoit des informations détaillées sur le pilote spécifié. Si ce paramètre n’est pas spécifié, DriverInfoDetailDataSize doit être égal à zéro. Si ce paramètre est spécifié, DriverInfoDetailData.cbSize doit être défini sur la valeur de sizeof(SP_DRVINFO_DETAIL_DATA) avant d’appeler SetupDiGetDriverInfoDetail.
[in] DriverInfoDetailDataSize
Taille, en octets, de la mémoire tampon DriverInfoDetailData.
[out, optional] RequiredSize
Pointeur vers une variable qui reçoit le nombre d’octets requis pour stocker les informations détaillées du pilote. Cette valeur inclut à la fois la taille de la structure et les octets supplémentaires requis pour la mémoire tampon de caractères de longueur variable à la fin qui contient la liste d’ID matériel et la liste d’ID compatibles. Les listes sont au format REG_MULTI_SZ. Pour plus d’informations sur le matériel et les ID compatibles, consultez chaînes d’identification d’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
Si le membre d’informations du pilote spécifié et la mémoire tampon fournie par l’appelant sont tous deux valides, cette fonction est garantie de remplir tous les champs statiques de la structure SP_DRVINFO_DETAIL_DATA et autant d’ID que possible dans la mémoire tampon de longueur variable à la fin tout en conservant le format REG_MULTI_SZ. Dans ce cas, la fonction retourne FALSE et un appel à GetLastError retourne ERROR_INSUFFICIENT_BUFFER. Si elle est spécifiée, RequiredSize contient le nombre total d’octets requis pour la structure avec tous les ID.
Note
L’en-tête setupapi.h définit SetupDiGetDriverInfoDetail 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 |