structure SP_DEVINFO_DATA (setupapi.h)
Une structure de SP_DEVINFO_DATA définit un instance d’appareil qui est membre d’un jeu d’informations d’appareil.
Syntaxe
typedef struct _SP_DEVINFO_DATA {
DWORD cbSize;
GUID ClassGuid;
DWORD DevInst;
ULONG_PTR Reserved;
} SP_DEVINFO_DATA, *PSP_DEVINFO_DATA;
Membres
cbSize
Taille, en octets, de la structure SP_DEVINFO_DATA. Pour plus d'informations, consultez la section Notes qui suit.
ClassGuid
GUID de la classe d’installation de l’appareil.
DevInst
Un handle opaque pour l’appareil instance (également appelé handle pour le devnode).
Certaines fonctions, telles que les fonctions SetupDiXxx , prennent l’ensemble de la structure SP_DEVINFO_DATA comme entrée pour identifier un appareil dans un jeu d’informations d’appareil. D’autres fonctions, telles que les fonctions CM_Xxx comme CM_Get_DevNode_Status, prennent ce handle DevInst comme entrée.
Reserved
Réservé. À usage interne uniquement.
Remarques
Une structure SP_DEVINFO_DATA identifie un appareil dans un jeu d’informations d’appareil. Par exemple, lorsque Windows envoie une demande de DIF_INSTALLDEVICE à un programme d’installation et à des co-programmes d’installation de classe, il inclut un handle vers un jeu d’informations d’appareil et un pointeur vers un SP_DEVINFO_DATA qui spécifie l’appareil particulier. En plus des requêtes DIF, cette structure est également utilisée dans certaines fonctions SetupDiXxx .
Les fonctions SetupDiXxx qui prennent une structure SP_DEVINFO_DATA en tant que paramètre vérifient que le membre cbSize de la structure fournie est égal à la taille, en octets, de la structure. Si le membre cbSize n’est pas défini correctement pour un paramètre d’entrée, la fonction échoue et définit un code d’erreur de ERROR_INVALID_PARAMETER. Si le membre cbSize n’est pas défini correctement pour un paramètre de sortie, la fonction échoue et définit un code d’erreur de ERROR_INVALID_USER_BUFFER.
Configuration requise
| En-tête | setupapi.h (inclure Setupapi.h) |