DevGen-Befehlssyntax

Hinweis

Dieses Tool darf nicht weiterverteilt werden und sollte nicht für Produktionsszenarien verwendet werden.

DevGen.exe finden Sie im Toolsordner des WDK ab Windows 11, Version 22H2. Er ermöglicht es einem Administrator, Softwaregeräte und Stammgeräte zu Testzwecken zu erstellen und zu entfernen.

Um DevGen auszuführen, öffnen Sie ein Eingabeaufforderungsfenster (Als Administrator ausführen), navigieren Sie zum Toolsordner, und geben Sie einen Befehl mithilfe der folgenden Syntax und Parameter ein.

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

Befehle

/add

Erstellen Sie ein Gerät.

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

Flaggen:

/bus <SWD | ROOT> – SWD listet ein Softwaregerät auf, das nach dem Neustart getrennt wird. ROOT listet ein Stammgerät auf, das beim Neustart beibehalten wird. Standardmäßig wird ein Softwaregerät erstellt.

/instanceid <instance ID> - eindeutige Instanz-ID, die beim Generieren eines Geräts verwendet werden soll.

/parent <device instance ID> - übergeordnetes Gerät zur Aufzählung des untergeordneten Geräts. Wird nur für Softwaregeräte unterstützt. Das Gerät wird standardmäßig unter HTREE\ROOT\0 aufgezählt.

/hardwareid <hardware ID> – Hardware-ID, die auf dem generierten Gerät festgelegt werden soll. Mehrere Hardware-ID können mit diesem Parameter mehrmals festgelegt werden.

/compatibleid <compatible ID> - kompatible ID, die auf dem generierten Gerät festgelegt werden soll. Mehrere kompatible ID können mit diesem Parameter mehrmals festgelegt werden.

/wait [<timeout in MS>] – Entfernen Sie das Gerät sofort nach einer Benutzereingabeaufforderung oder einem optionalen Timeout. Timeout in Millisekunden angegeben.

/unplug - modifiziert den Parameter "/wait", um das Gerät zu deaktivieren, ohne es physisch zu entfernen. Das Gerät bleibt als nicht präsenter Geräteknoten. Nur gültig beim Generieren eines Softwaregeräts mit /wait-Parameter.

/subtree - entfernen Sie den gesamten Gerätebaum, einschließlich aller untergeordneten Geräte.

/remove

Entfernen Sie ein Gerät, das durch die Geräteinstanz-ID angegeben ist. Nur Geräte, die mit DevGen erstellt wurden, können mit DevGen entfernt werden.

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

Flaggen:

/subtree - entfernen Sie den gesamten Gerätebaum, einschließlich aller untergeordneten Geräte.

Software-Gerät vs Root-Enumerated-Gerät

Standardmäßig erstellt DevGen ein Softwaregerät. Softwaregeräte sind die empfohlenen Testgeräte, da sie bei einem Neustart nicht erhalten bleiben und das System nicht belasten. Verwenden Sie aufgezählte Stammgeräte nur für Testfälle, für die ein Systemneustart erforderlich ist.

Beispiele

Beispiele finden Sie unter DevGen Examples.