Sintaxe do comando DevGen

Observação

Esta ferramenta não pode ser redistribuída e não deve ser usada para cenários de produção.

DevGen.exe pode ser encontrado na pasta de ferramentas do WDK a partir do Windows 11, versão 22H2. Ele permite que um administrador crie e remova dispositivos de software e dispositivos enumerados raiz para fins de teste.

Para executar o DevGen, abra uma janela de prompt de comando (Executar como administrador), navegue até a pasta de ferramentas e digite um comando usando a sintaxe e os parâmetros a seguir.

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

Comandos

/add

Crie um dispositivo.

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

Bandeiras:

/bus <SWD | ROOT> - SWD enumera um dispositivo de software que será desconectado após a reinicialização. ROOT enumera um dispositivo raiz que persistirá durante a reinicialização. Um dispositivo de software será criado por padrão.

/instanceid <instance ID> - ID de instância exclusivo para usar ao gerar um dispositivo.

/parent <device instance ID> - dispositivo pai para enumerar o dispositivo em. Suportado apenas para dispositivos de software. O dispositivo é enumerado em HTREE\ROOT\0 por padrão.

/hardwareid <hardware ID> - ID de hardware para definir no dispositivo gerado. Mais de um ID de hardware pode ser definido usando esse parâmetro várias vezes.

/compatibleid <compatible ID> - ID compatível para definir no dispositivo gerado. Mais de um ID compatível pode ser definido usando esse parâmetro várias vezes.

/wait [<timeout in MS>] - Remova o dispositivo imediatamente após aguardar o prompt do usuário ou o tempo limite opcional. Tempo limite especificado em milissegundos.

/unplug - modifica o parâmetro /wait para desligar o dispositivo sem retirar. O dispositivo permanecerá como um nó de dispositivo não presente. Válido apenas ao gerar um dispositivo de software com o parâmetro /wait.

/subtree - Remova toda a subárvore do dispositivo, incluindo todos os dispositivos subordinados.

/remove

Remova um dispositivo especificado pelo ID da instância do dispositivo. Somente dispositivos criados usando DevGen podem ser removidos com DevGen.

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

Bandeiras:

/subtree - Remova toda a subárvore do dispositivo, incluindo todos os dispositivos subordinados.

Dispositivo de software vs dispositivo Root-Enumerated

Por padrão, o DevGen cria um dispositivo de software. Os dispositivos de software são os dispositivos de teste recomendados, uma vez que não persistem durante a reinicialização e não sobrecarregam o sistema. Use dispositivos enumerados pela raiz somente para casos de teste que exigem uma reinicialização do sistema.

Exemplos

Para obter exemplos, consulte Exemplos de DevGen.