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 Notes qui suit.

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 ensemble d’informations d’appareil.

Les fonctions SetupDiXxx qui prennent une structure SP_DEVICE_INTERFACE_DETAIL_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.

Notes

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

Condition requise Valeur
En-tête setupapi.h (inclure Setupapi.h)

Voir aussi

SetupDiGetDeviceInterfaceDetail