Składnia polecenia DevGen

Uwaga / Notatka

To narzędzie nie może być dystrybuowane i nie powinno być używane w scenariuszach produkcyjnych.

Plik DevGen.exe można znaleźć w katalogu narzędzi zestawu WDK, począwszy od systemu Windows 11, wersja 22H2. Umożliwia ona administratorowi tworzenie i usuwanie urządzeń oprogramowania oraz urządzeń wyliczanych przez root na potrzeby testowania.

Aby uruchomić program DevGen, otwórz okno wiersza polecenia (Uruchom jako administrator), przejdź do folderu tools i wpisz polecenie przy użyciu następującej składni i parametrów.

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

Komendy

/add

Tworzenie urządzenia.

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

Flagi:

/bus <SWD | ROOT> — SWD wylicza urządzenie programowe, które rozłączy się po ponownym uruchomieniu. ROOT wylicza urządzenie główne, które będzie utrwalane podczas ponownego uruchamiania. Domyślnie zostanie utworzone urządzenie programowe.

/instanceid <instance ID> - unikalny identyfikator instancji do użycia przy generowaniu urządzenia.

/parent <device instance ID> — urządzenie nadrzędne do wyliczania urządzeń podrzędnych. Obsługiwane tylko w przypadku urządzeń z oprogramowaniem. Urządzenie jest domyślnie enumerowane pod HTREE\ROOT\0.

/hardwareid <hardware ID> — identyfikator sprzętu ustawiony na wygenerowanym urządzeniu. Więcej niż jeden identyfikator sprzętu można ustawić za pomocą tego parametru wiele razy.

/compatibleid <compatible ID> — zgodny identyfikator ustawiony na wygenerowanym urządzeniu. Można ustawić więcej niż jeden zgodny identyfikator, używając tego parametru wiele razy.

/wait [<timeout in MS>] — usuń urządzenie natychmiast po oczekiwaniu na monit użytkownika lub opcjonalny limit czasu. Limit czasu określony w milisekundach.

/unplug - modyfikuje /wait parametr do odłączania urządzenia bez usuwania. Urządzenie pozostanie węzłem urządzenia, który nie jest obecny. Tylko ważne podczas generowania urządzenia programowego z parametrem /wait.

/subtree — usuń całe poddrzewo urządzenia, w tym wszystkie urządzenia podrzędne.

/remove

Usuń urządzenie określone przez identyfikator wystąpienia urządzenia. W usłudze DevGen można usuwać tylko urządzenia utworzone przy użyciu narzędzia DevGen.

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

Flagi:

/subtree — usuń całe poddrzewo urządzenia, w tym wszystkie urządzenia podrzędne.

Urządzenie programowe a urządzenie Root-Enumerated

Domyślnie program DevGen tworzy urządzenie programowe. Urządzenia programowe są zalecanymi urządzeniami testowymi, ponieważ nie są utrwalane podczas ponownego uruchamiania i nie będą zaśmiecać systemu. Używaj urządzeń wyliczanych przez katalog główny tylko w przypadku przypadków testowych, które wymagają ponownego uruchomienia systemu.

Przykłady

Przykłady można znaleźć w temacie DevGen Examples (Przykłady metodyki DevGen).