Syntaxe de la commande DevGen

Article
03/08/2023

Notes

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 tools du WDK à partir de Windows 11, version 22H2. Il permet à un administrateur de créer et de supprimer des appareils logiciels et des appareils énumérés racine à des fins de test.

Pour exécuter DevGen, ouvrez une fenêtre d’invite de commandes (Exécuter en tant qu’administrateur), accédez au dossier tools 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]

Flags :

/bus <SWD | ROOT> - SWD énumère un périphérique logiciel qui se déconnectera après le redémarrage. ROOT énumère un appareil racine qui sera conservé tout au long du redémarrage. Un périphérique logiciel est créé par défaut.

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

/parent <device instance ID> - appareil parent sous lequel énumérer l’appareil. Pris en charge uniquement pour les appareils 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 l’attente d’une invite de l’utilisateur ou d’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 supprimer. L’appareil restera 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 - supprimer l’intégralité de la sous-arborescence de l’appareil, y compris les appareils enfants.

/remove

Supprimez un appareil spécifié par l’ID de 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]

Flags :

/subtree - supprimer l’intégralité de la sous-arborescence de l’appareil, y compris les appareils enfants.

Périphérique logiciel et appareil Root-Enumerated

Par défaut, DevGen crée un périphérique logiciel. Les appareils logiciels sont les appareils de test recommandés, car ils ne sont pas persistants pendant le 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.

Partager via