structure SP_DEVICE_INTERFACE_DETAIL_DATA_A (setupapi.h)

  • Article

Une structure SP_DEVICE_INTERFACE_DETAIL_DATA contient le chemin d’accès d’une interface d’appareil.

Syntaxe

typedef struct _SP_DEVICE_INTERFACE_DETAIL_DATA_A {
  DWORD cbSize;
  CHAR  DevicePath[ANYSIZE_ARRAY];
} SP_DEVICE_INTERFACE_DETAIL_DATA_A, *PSP_DEVICE_INTERFACE_DETAIL_DATA_A;

Membres

cbSize

Taille, en octets, de la structure SP_DEVICE_INTERFACE_DETAIL_DATA. Pour plus d’informations, consultez la section Remarques suivante.

DevicePath[ANYSIZE_ARRAY]

Chaîne terminée par NULL qui contient le chemin d’accès de l’interface de l’appareil. Ce chemin d’accès peut être passé à des fonctions Win32 telles que CreateFile.

Remarques

Une structure SP_DEVICE_INTERFACE_DETAIL_DATA identifie le chemin d’accès d’une interface d’appareil dans un jeu d’informations sur l’appareil.

fonctions SetupDiXxx qui prennent une structure SP_DEVICE_INTERFACE_DETAIL_DATA comme paramètre vérifient que le membre cbSize de la structure fournie est égal à la taille, en octets, de la structure. Si le cbSize membre 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 cbSize membre 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.

Note

L’en-tête setupapi.h définit SP_DEVICE_INTERFACE_DETAIL_DATA en tant qu’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
d’en-tête setupapi.h (include Setupapi.h)

Voir aussi

SetupDiGetDeviceInterfaceDetail