INF AddComponent ディレクティブ

  • [アーティクル]

AddComponent ディレクティブは、INF DDInstall 使用されます。 拡張 INF ファイル の Componentsセクション。 現在のデバイスの下にソフトウェア コンポーネントの仮想子デバイスが作成されます。 この要素は、Windows 10 バージョン 1703 以降でサポートされています。

[DDInstall.Components]

AddComponent=ComponentName,[flags],component-install-section

エントリ

ComponentName

作成するソフトウェア コンポーネントの名前を指定します。 INF ファイル内の各 AddComponent ディレクティブには、一意の値が必要です。

flags

1 つ以上の (ORed) フラグを指定します。現在は未定義ですが、将来使用するために予約されています。

component-install-section

このデバイスの名前付きソフトウェア コンポーネントを作成するための情報を含む INF ライター定義セクションを参照します。

解説

INF ライターで定義された各セクション名は、INF ファイル内で一意である必要があり、セクション名を定義するための一般的な規則に従う必要があります。 これらの規則の詳細については、「 INF ファイルの一般的な構文規則」を参照してください。

AddComponent ディレクティブは、INFファイル中の component-install-section を参照しなければなりません。 このような各セクションの形式は次のとおりです。

[component-install-section]

ComponentIDs=component-id[,component-id] …
[Description=description]

各 component-install-section には、次に示すように、 少なくとも ComponentID エントリが必要です。 ただし、残りのエントリはオプションです。

ComponentID はHardwareID であり、ハードウェア開発者によって定義された文字列であることを意味します。 これらの ID の一意性を確保するために、ほとんどの場合、 PCI デバイス に使用される識別子スキーマに従うことをお勧めします。 ベンダーが別のスキーマを使用したい場合もありますが、シナリオによって異なります。

たとえば、1 つのデバイスに複数のコンポーネントがあるベンダーは、コンポーネントのハードウェア ID を親に関連付けることができます。 この場合、4 文字のベンダー定義コンポーネント識別子を親のハードウェア ID に追加することで、 ComponentID を作成できます。

Component-Install セクションのエントリと値

ComponentIDs=id1[, id2] ...[, idN]

ソフトウェア コンポーネントのコンポーネント識別子を指定します。 コンポーネント ID はハードウェア ID と同じように動作し、 同様の書式設定 に従う必要があります。 ソフトウェア コンポーネントの場合、システムは INF で提供される値の先頭に SWC\ ハードウェア ID を作成します。 たとえば、 ComponentIDs 値の場合、 VID0001&PID0001 ハードウェア ID SWC\VID0001&PID0001 になります。

Description=description

必要に応じて、 INF 文字列セクション で定義された %strkey% トークンとして表される、通常はローカライズ用のソフトウェア コンポーネントを記述する文字列を指定します。

説明文字列に %strkey% トークンが含まれている場合、各トークンは最大 511 文字を表すことができます。 文字列トークンの置換後の合計文字列は、1024 文字を超えないようにしてください。

参照

コンポーネント INF ファイルの使用

DDInstall.コンポーネント

INF AddSoftware ディレクティブ