Fonction SetupDiGetDriverInfoDetailA (setupapi.h)

Article
08/26/2023

La fonction SetupDiGetDriverInfoDetail récupère les détails des informations sur le pilote pour un jeu d’informations d’appareil ou un élément d’informations sur l’appareil particulier dans le jeu d’informations de périphérique.

Syntaxe

WINSETUPAPI BOOL SetupDiGetDriverInfoDetailA(
  [in]            HDEVINFO                  DeviceInfoSet,
  [in, optional]  PSP_DEVINFO_DATA          DeviceInfoData,
  [in]            PSP_DRVINFO_DATA_A        DriverInfoData,
  [in, out]       PSP_DRVINFO_DETAIL_DATA_A DriverInfoDetailData,
  [in]            DWORD                     DriverInfoDetailDataSize,
  [out, optional] PDWORD                    RequiredSize
);

Paramètres

[in] DeviceInfoSet

Handle d’un jeu d’informations d’appareil qui contient un élément d’informations sur le pilote pour lequel récupérer des informations sur le pilote.

[in, optional] DeviceInfoData

Pointeur vers une structure de SP_DEVINFO_DATA qui spécifie un élément d’informations sur l’appareil qui représente l’appareil pour lequel récupérer des informations sur le 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 a la valeur NULL, SetupDiGetDriverInfoDetail récupère des informations sur un pilote qui est membre de la liste des pilotes de classe globale pour DeviceInfoSet.

[in] DriverInfoData

Pointeur vers une structure de SP_DRVINFO_DATA qui spécifie l’élément d’informations sur le pilote qui représente le pilote pour lequel récupérer des 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 de 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 sizeof(SP_DRVINFO_DETAIL_DATA) avant d’appeler SetupDiGetDriverInfoDetail.

RemarqueDriverInfoDetailData.cbSize ne doit pas être défini sur la valeur du paramètre DriverInfoDetailDataSize.

[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 sur le 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 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

Si le membre d’informations sur le pilote spécifié et la mémoire tampon fournie par l’appelant sont tous deux valides, cette fonction est garantie pour 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 REG_MULTI_SZ format. Dans ce cas, la fonction retourne FALSE et un appel à GetLastError retourne ERROR_INSUFFICIENT_BUFFER. Si spécifié, RequiredSize contient le nombre total d’octets requis pour la structure avec tous les ID.

Notes

L’en-tête setupapi.h définit SetupDiGetDriverInfoDetail 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


Client minimal pris en charge	Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows.
Plateforme cible	Bureau
En-tête	setupapi.h (inclure Setupapi.h)
Bibliothèque	Setupapi.lib

Voir aussi

SetupDiEnumDriverInfo

SetupDiGetSelectedDriver

Partager via