Syntaxe de commande DevGen

Remarque

Cet outil n’est pas autorisé à être redistribué et ne doit pas être utilisé pour les scénarios de production.

DevGen.exe se trouve dans le dossier outils du WDK à partir de Windows 11, version 22H2. Il permet à un administrateur de créer et de supprimer des appareils logiciels et des appareils racine énumérés à des fins de tests.

Pour exécuter DevGen, ouvrez une fenêtre d’invite de commandes (Exécuter en tant qu’administrateur), accédez au dossier outils et tapez une commande à l’aide de la syntaxe et des paramètres suivants.

DEVGEN [/add [<…>] | /remove <…>| /?]

Commandes

/add

Créez un appareil.

DEVGEN /add [/bus <SWD | ROOT>] [/instanceid <instance ID>] 
            [/parent <device instance ID>] [/hardwareid <hardware ID>] 
            [/compatibleid <compatible ID>] [/wait [<timeout in MS>]] 
            [/unplug] [/subtree]

Drapeaux:

/bus <SWD | ROOT> - SWD énumère un appareil logiciel qui se déconnecte après le redémarrage. ROOT énumère un appareil racine qui persistera lors du redémarrage. Un appareil logiciel est créé par défaut.

/instanceid <instance ID> - ID d’instance unique à utiliser lors de la génération d’un appareil.

/parent <device instance ID> - Appareil parent sous lequel énumérer l'appareil sous-jacent. Uniquement pris en charge pour les dispositifs logiciels. L’appareil est énuméré sous HTREE\ROOT\0 par défaut.

/hardwareid <hardware ID> - ID matériel à définir sur l’appareil généré. Plusieurs ID matériels peuvent être définis à l’aide de ce paramètre plusieurs fois.

/compatibleid <compatible ID> - ID compatible à définir sur l’appareil généré. Plusieurs ID compatibles peuvent être définis à l’aide de ce paramètre plusieurs fois.

/wait [<timeout in MS>] : supprimez l’appareil immédiatement après avoir attendu l’invite de l’utilisateur ou un délai d’expiration facultatif. Délai d’expiration spécifié en millisecondes.

/unplug - modifie le paramètre /wait pour débrancher l’appareil sans le retirer. L’appareil reste en tant que nœud d’appareil non présent. Valide uniquement lors de la génération d’un appareil logiciel avec le paramètre /wait.

/subtree : supprimez toute la sous-arborescence de l’appareil, y compris les appareils enfants.

/remove

Supprimez un appareil spécifié par l’ID d’instance de l’appareil. Seuls les appareils créés à l’aide de DevGen peuvent être supprimés avec DevGen.

DEVGEN /remove <device instance ID> [/subtree]

Drapeaux:

/subtree : supprimez toute la sous-arborescence de l’appareil, y compris les appareils enfants.

Appareil logiciel versus appareil Root-Enumerated

Par défaut, DevGen crée un appareil logiciel. Les appareils logiciels sont les appareils de test recommandés, car ils ne sont pas conservés au cours du redémarrage et n’encombrent pas le système. Utilisez des appareils énumérés par la racine uniquement pour les cas de test qui nécessitent un redémarrage du système.

Exemples

Pour obtenir des exemples, consultez Exemples DevGen.