2026-06-02

USB Interface Association Descriptor (IAD) et débogage de périphérique composite

Corrigez les erreurs de descripteur IAD et de liaison de pilote de périphérique composite USB. Couvre usbccgp.sys Windows, Code 10, Code 43, descripteurs d'interface et échecs partiels d'énumération.

Les périphériques composites USB exposent plusieurs fonctions à travers un seul périphérique USB physique. Un même périphérique peut fournir des contrôles HID, du CDC série, du stockage de masse, du diagnostic vendor, de l'audio, de la vidéo et des interfaces de mise à jour firmware. Quand la liaison de pilote se passe mal, les utilisateurs voient « USB Composite Device driver error », « This device cannot start Code 10 », « Code 43 », « interface not working », « COM port missing » ou « one function works but another does not ».

Les recherches comme « USB composite device wrong driver », « Windows usbccgp Code 10 », « USB interface driver not binding » ou « IAD descriptor debugging » exigent généralement des preuves au niveau du bus. L'état du pilote Windows seul ne montre pas si les descripteurs décrivent les fonctions correctement.

Bus Scope aide car la liaison composite est pilotée par les descripteurs.

Comment les périphériques composites sont structurés

Un périphérique composite contient un descripteur de périphérique et une ou plusieurs configurations. À l'intérieur d'une configuration, il expose plusieurs interfaces. Chaque interface a des valeurs class/subclass/protocol et des endpoints.

Exemples de fonctions :

Interface 0 : HID
Interface 1 : contrôle CDC
Interface 2 : données CDC
Interface 3 : diagnostics vendor

Windows utilise le pilote parent générique USB, souvent usbccgp.sys, pour énumérer les fonctions enfants et lier les pilotes appropriés.

Interface Association Descriptor

L'IAD regroupe plusieurs interfaces en une fonction. CDC ACM utilise couramment une interface de contrôle et une interface de données. Sans IAD correcte, l'OS peut les lier incorrectement ou les traiter comme des interfaces non liées.

Symptômes d'IAD incorrecte :

port COM série CDC manquant
fonction audio partiellement présente
caméra UVC énumérée mais interface vidéo en échec
interface vendor vole le mauvais pilote
seule une sous-fonction marche

Vérifiez soigneusement les numéros d'interface et les plages d'IAD.

Codes de classe et choix du pilote

La liaison de pilote dépend des codes class/subclass/protocol au niveau du périphérique ou de l'interface. Une class au niveau périphérique de 0x00 signifie que la class est définie par interface. Une class au niveau périphérique de 0xEF est souvent utilisée pour les périphériques composites divers avec IAD.

Si le firmware déclare un mauvais code de classe, Windows peut choisir le mauvais pilote.

Pour les périphériques personnalisés, soyez délibéré :

les interfaces HID doivent décrire HID correctement
les interfaces CDC doivent correspondre aux attentes CDC
les interfaces vendor doivent utiliser la vendor class
les interfaces WinUSB peuvent nécessiter des descripteurs Microsoft OS

Code 10 et Code 43

Code 10 et Code 43 sont des symptômes OS, pas des causes racines. La trace USB peut révéler si :

le descripteur de périphérique a été lu
le descripteur de configuration est valide
les descripteurs d'interface sont cohérents
les descripteurs d'endpoint correspondent aux attentes d'interface
les descripteurs spécifiques à la classe sont mal formés
le pilote a émis une requête de classe qui a stallé
le périphérique a été resete pendant la liaison

Si l'énumération réussit mais qu'une requête de classe échoue, le problème est en aval de la lecture de base des descripteurs.

Défaillance partielle du périphérique

Les périphériques composites peuvent fonctionner partiellement. Par exemple, les boutons HID marchent mais pas le CDC série. Cela signifie que le périphérique n'est pas simplement « mort ». Cela signifie qu'un chemin d'interface a échoué.

Conservez :

tous les descripteurs d'interface
les descripteurs spécifiques à la classe
les numéros d'interface
les requêtes de classe du pilote
le trafic d'endpoint pour l'interface défaillante

Checklist de débogage

Suivez ce flux :

Capturez dès le branchement.
Inspectez les class/subclass/protocol au niveau périphérique.
Inspectez la longueur totale de configuration et le nombre d'interfaces.
Inspectez chaque descripteur d'interface.
Inspectez les descripteurs IAD et plages d'interfaces.
Inspectez les descripteurs spécifiques à la classe.
Identifiez quelle interface échoue à se lier.
Cherchez les requêtes de classe stalled.
Comparez Windows, Linux et une autre machine Windows si nécessaire.
Conservez les descripteurs avant d'éditer les captures.

Diagnostic final

Les échecs de liaison de pilote composite USB viennent généralement des contrats de descripteurs : codes de classe, numéros d'interface, regroupement IAD, descripteurs spécifiques à la classe, descripteurs Microsoft OS ou requêtes de classe pendant le démarrage du pilote.

Bus Scope aide à exposer ces contrats pour qu'un « USB Composite Device driver error » puisse être tracé jusqu'à l'interface exacte et la preuve de descripteur.

Test du contrat USB pour « USB Interface Association Descriptor (IAD) et débogage de périphérique composite »

La réponse directe est qu’un STALL, timeout ou reset n’explique pas seul la cause. Prouvez d’abord que le fournisseur voit le bon périphérique, puis lisez le contrat du transfer : type, direction, recipient, wValue, wIndex, longueur annoncée et réelle, status et état avant/après. Pour « USB Interface Association Descriptor (IAD) et débogage de périphérique composite », reliez la conclusion à la première transaction différente d’un cas nominal.

Limite	Comparaison	Décision
Plateforme	fournisseur, droits, Root Hub ou usbmon/XHC20	Les records viennent-ils de la bonne connexion ?
Setup	bmRequestType, bRequest, wValue, wIndex, wLength	L’hôte envoie-t-il la requête prévue ?
Data	direction, longueur et bytes conservés	Le payload respecte-t-il le contrat ?
Status	ACK, STALL, timeout ou cancellation	Où finit réellement la transaction ?
État	configuration, interface, alternate setting, endpoint halt	Le périphérique était-il prêt ?

Commencez avant reset et énumération et gardez descriptors, SET_CONFIGURATION, SET_INTERFACE et la commande avant défaut. Un filtre endpoint étroit peut masquer le control transfer décisif. Exécutez une seule action USB documentée par essai et ne changez que firmware, driver, port, câble, commande ou timing.

Comment rédiger une réponse réutilisable ?

Nommez requête, champs setup, réponse et contexte précédent, puis un test à variable unique. Des bytes non retenus ne prouvent pas packet loss. La proximité entre command et reset établit une corrélation, pas la cause sans répétition ou transition d’état.

Quand la comparaison est-elle valide ?

Gardez VID/PID, firmware, speed, topologie, fournisseur, filtre et trigger. Comparez les phases USB sémantiques, pas les frame numbers entre usbmon et USBPcap. Notez début, fin, version, OS, connexion et checksum. Consultez le dépannage Bus Scope.

Les propriétaires Semrush restent distincts : free USB analyzer sur la page produit, best USB protocol analyzer dans la comparaison et USB descriptor viewer dans le guide descriptor. Aucun volume ou KD n’est inventé pour cette page de support.

Réponse directe et limite d’acceptation

La réponse courte à « USB Interface Association Descriptor (IAD) et débogage de périphérique composite » est la suivante : Corrigez les erreurs de descripteur IAD et de liaison de pilote de périphérique composite USB. Couvre usbccgp.sys Windows, Code 10, Code 43, descripteurs d'interface et échecs partiels d'énumération. Considérez cette phrase comme un résultat à vérifier, et non comme une promesse valable pour toute entrée, tout appareil, tout projet ou tout environnement. Un résultat complet consigne l’état initial, l’action exacte, la sortie visible et la condition qui prouve la fin de la tâche dans Bus Scope.

Procédure fondée sur les preuves

Commencez par un cas petit et répétable avant de modifier un projet complet. Notez version de l’application, système, identité de l’entrée ou de l’appareil, réglages pertinents et résultat attendu. Exécutez une action volontaire, conservez la première transition inattendue et comparez-la à un cas nominal si possible. Plusieurs changements simultanés masquent la condition qui a créé ou corrigé le problème.

Point de contrôle 1 : USB Interface Association Descriptor (IAD) et débogage de périphérique composite

Pour « USB Interface Association Descriptor (IAD) et débogage de périphérique composite », séparez une décision du produit d’une limite du système, du matériel, du fichier source, des droits ou du processus. Confirmez la couche qui fournit la preuve avant d’attribuer une cause. Un symptôme voisin ne devient ainsi pas une cause racine prétendument prouvée.

Point de contrôle 2 : Corrigez les erreurs de descripteur IAD et de liaison de pilote de périphérique composite

Ne fermez « Corrigez les erreurs de descripteur IAD et de liaison de pilote de périphérique composite USB. Couvre usbccgp.sys Windows, Code 10, Code 43, descripte » que lorsque le résultat enregistré, exporté ou rouvert correspond encore à l’état observé. Le retour temporaire de l’interface aide, mais une preuve durable est plus forte. Consignez toute limite restante pour la suite.

Point de contrôle 3 : Comment les périphériques composites sont structurés

Pour « Comment les périphériques composites sont structurés », séparez une décision du produit d’une limite du système, du matériel, du fichier source, des droits ou du processus. Confirmez la couche qui fournit la preuve avant d’attribuer une cause. Un symptôme voisin ne devient ainsi pas une cause racine prétendument prouvée.

Point de contrôle 4 : Interface Association Descriptor

Ne fermez « Interface Association Descriptor » que lorsque le résultat enregistré, exporté ou rouvert correspond encore à l’état observé. Le retour temporaire de l’interface aide, mais une preuve durable est plus forte. Consignez toute limite restante pour la suite.

Point de contrôle 5 : Codes de classe et choix du pilote

Pour « Codes de classe et choix du pilote », séparez une décision du produit d’une limite du système, du matériel, du fichier source, des droits ou du processus. Confirmez la couche qui fournit la preuve avant d’attribuer une cause. Un symptôme voisin ne devient ainsi pas une cause racine prétendument prouvée.

Point de contrôle 6 : Code 10 et Code 43

Ne fermez « Code 10 et Code 43 » que lorsque le résultat enregistré, exporté ou rouvert correspond encore à l’état observé. Le retour temporaire de l’interface aide, mais une preuve durable est plus forte. Consignez toute limite restante pour la suite.

Point de contrôle 7 : Défaillance partielle du périphérique

Pour « Défaillance partielle du périphérique », séparez une décision du produit d’une limite du système, du matériel, du fichier source, des droits ou du processus. Confirmez la couche qui fournit la preuve avant d’attribuer une cause. Un symptôme voisin ne devient ainsi pas une cause racine prétendument prouvée.

Point de contrôle 8 : Checklist de débogage

Ne fermez « Checklist de débogage » que lorsque le résultat enregistré, exporté ou rouvert correspond encore à l’état observé. Le retour temporaire de l’interface aide, mais une preuve durable est plus forte. Consignez toute limite restante pour la suite.

Point de contrôle 9 : Diagnostic final

Pour « Diagnostic final », séparez une décision du produit d’une limite du système, du matériel, du fichier source, des droits ou du processus. Confirmez la couche qui fournit la preuve avant d’attribuer une cause. Un symptôme voisin ne devient ainsi pas une cause racine prétendument prouvée.

Point de contrôle 10 : Test du contrat USB pour « USB Interface Association Descriptor (IAD) et débogage de périp

Ne fermez « Test du contrat USB pour « USB Interface Association Descriptor (IAD) et débogage de périphérique composite » » que lorsque le résultat enregistré, exporté ou rouvert correspond encore à l’état observé. Le retour temporaire de l’interface aide, mais une preuve durable est plus forte. Consignez toute limite restante pour la suite.

Matrice d’acceptation

Point	Preuve à conserver	Critère de réussite
USB Interface Association Descriptor (IAD) et débogage de périphérique composite	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
Corrigez les erreurs de descripteur IAD et de liaison de pilote de périphérique composite USB. Couvre usbccgp.sys Window	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
Comment les périphériques composites sont structurés	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
Interface Association Descriptor	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
Codes de classe et choix du pilote	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
Code 10 et Code 43	État initial, une action et état obtenu	Une seconde personne reproduit le résultat

Isolation, reprise et transmission

Arrêtez-vous à la première limite en échec. Conservez source, projet, session ou capture, dupliquez avant toute modification destructive et changez une variable par essai. Rejouer un flux entier après plusieurs changements peut modifier le résultat sans expliquer pourquoi.

Distinguez absence de preuve et preuve d’absence. Une vue vide peut signaler mauvaise entrée, portée, filtre, permission, appareil, période ou état du projet. Vérifiez acquisition ou import avant d’interpréter décodeur, éditeur, rapport ou export.

Avant transmission, rouvrez l’artefact durable et inspectez début, point de décision et fin. Notez version, plateforme, configuration, attente, observation et reproduction minimale. Retirez ou masquez les données sensibles et confirmez l’autorisation du destinataire.

Questions et réponses

Quelle est la manière fiable la plus rapide de commencer ?

Utilisez le plus petit cas représentatif, écrivez le résultat attendu et ne changez qu’une variable. Validez le parcours de base avant d’ajouter filtres, effets, modifications, automatisation ou grande source.

Quelles preuves faut-il conserver ?

Gardez identité de l’entrée, version, plateforme, réglages, action exacte, première transition inattendue et sortie finale. Fermez puis rouvrez projet, session, rapport ou export avant de le considérer durable.

Quand faut-il répéter la procédure ?

Répétez-la après un changement pertinent d’application, système, pilote, firmware, modèle, source ou processus. Conservez le cas accepté précédent comme référence non modifiée.

Quand le résultat est-il transmissible ?

Lorsqu’une seconde personne autorisée identifie l’entrée, répète l’action, obtient le même résultat, comprend les limites et ouvre l’artefact sans état local non documenté.

Guides associés

Ces pages dans la même langue couvrent les étapes voisines sans changer le propriétaire canonique du sujet :