DevGen-Befehlssyntax

Artikel
03/08/2023

Hinweis

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

DevGen.exe finden Sie im Ordner tools des WDK ab Windows 11 Version 22H2. Es ermöglicht einem Administrator , Softwaregeräte und Root-enumerierte Geräte zu Testzwecken zu erstellen und zu entfernen.

Öffnen Sie zum Ausführen von DevGen ein Eingabeaufforderungsfenster (Als Administrator ausführen), navigieren Sie zum Ordner tools, und geben Sie einen Befehl mit der folgenden Syntax und den folgenden Parametern ein.

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

Befehle

/add

Gerät erstellen.

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 listet ein Softwaregerät auf, das nach dem Neustart getrennt wird. ROOT listet ein Stammgerät auf, das während des Neustarts beibehalten wird. Ein Softwaregerät wird standardmäßig erstellt.

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

/parent <device instance ID> - übergeordnetes Gerät, unter dem das Gerät aufgelistet werden soll. 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 mithilfe dieses Parameters mehrmals festgelegt werden.

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

/wait [<timeout in MS>] - Entfernen Sie das Gerät sofort nach dem Warten auf Benutzereingabeaufforderung oder optionales Timeout. In Millisekunden angegebenes Timeout.

/unplug – ändert den /wait-Parameter, um das Gerät zu trennen, ohne das Gerät zu entfernen. Das Gerät bleibt als nicht vorhandener Geräteknoten erhalten. Nur gültig, wenn ein Softwaregerät mit dem Parameter /wait generiert wird.

/subtree - Entfernen Sie die gesamte Unterstruktur des Geräts, einschließlich aller untergeordneten Geräte.

/remove

Entfernen Sie ein Gerät, das von der Geräte-instance-ID angegeben wird. Nur Geräte, die mit DevGen erstellt wurden, können mit DevGen entfernt werden.

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

Flags:

/subtree - Entfernen Sie die gesamte Unterstruktur des Geräts, einschließlich aller untergeordneten Geräte.

Softwaregerät im Vergleich zu Root-Enumerated Gerät

Standardmäßig erstellt DevGen ein Softwaregerät. Softwaregeräte sind die empfohlenen Testgeräte, da sie während des Neustarts nicht beibehalten werden und das System nicht überladen. Verwenden Sie root-enumerierte Geräte nur für Testfälle, die einen Systemneustart erfordern.

Beispiele

Beispiele finden Sie unter DevGen-Beispiele.

Freigeben über