DevGen コマンド構文
Note
このツールは再配布が許可されていないため、運用環境のシナリオでは使用しないでください。
DevGen.exe は、Windows 11 バージョン 22H2 以降の WDK の tools フォルダーにあります。 管理者は、これを使用して、ソフトウェア デバイスとルート列挙デバイスをテスト目的で作成および削除できます。
DevGen を実行するには、コマンド プロンプト ウィンドウ (管理者として実行) を開き、tools フォルダーに移動し、次の構文とパラメーターを使用してコマンドを入力します。
DEVGEN [/add [<…>] | /remove <…>| /?]
コマンド
/add
デバイスを作成します。
DEVGEN /add [/bus <SWD | ROOT>] [/instanceid <instance ID>]
[/parent <device instance ID>] [/hardwareid <hardware ID>]
[/compatibleid <compatible ID>] [/wait [<timeout in MS>]]
[/unplug] [/subtree]
フラグ:
/bus <SWD | ROOT>
- SWD は、再起動後に切断されるソフトウェア デバイスを列挙します。 ROOT は、再起動後も保持されるルート デバイスを列挙します。 既定では、ソフトウェア デバイスが作成されます。
/instanceid <instance ID>
- デバイスの生成時に使用する一意のインスタンス ID。
/parent <device instance ID>
- デバイスを列挙する親デバイス。 ソフトウェア デバイスでのみサポートされます。 既定では、デバイスは HTREE\ROOT\0 の下に列挙されます。
/hardwareid <hardware ID>
- 生成されたデバイスに設定するハードウェア ID。 このパラメーターを複数回使用して、複数のハードウェア ID を設定できます。
/compatibleid <compatible ID>
- 生成されたデバイスに設定する互換性 ID。 このパラメーターを複数回使用して、複数の互換性 ID を設定できます。
/wait [<timeout in MS>]
- ユーザー プロンプトまたはオプションのタイムアウトを待機した直後にデバイスを削除します。 タイムアウト (ミリ秒)。
/unplug
- /wait パラメーターを変更して、デバイスを取り外さずに接続解除します。 デバイスは、存在しないデバイス ノードとして残ります。 /wait パラメーターを使用してソフトウェア デバイスを生成する場合にのみ有効です。
/subtree
- 子デバイスを含め、デバイス サブツリー全体を削除します。
/remove
デバイス インスタンス ID で指定されたデバイスを削除します。 DevGen で削除できるのは、DevGen を使用して作成されたデバイスのみです。
DEVGEN /remove <device instance ID> [/subtree]
フラグ:
/subtree
- 子デバイスを含め、デバイス サブツリー全体を削除します。
ソフトウェア デバイスとルート列挙デバイス
既定では、DevGen はソフトウェア デバイスを作成します。 ソフトウェア デバイスは、再起動しても保持されず、システムを煩雑にしないため、テスト デバイスとして推奨されます。 ルート列挙デバイスは、システムの再起動が必要なテスト ケースにのみ使用します。
例
例については、「DevGen の例」を参照してください。