structure SP_DEVINFO_DATA (setupapi.h)

  • Article

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)

Voir aussi

SP_DEVINFO_LIST_DETAIL_DATA