DDInstall。HW セクションは、通常、多機能デバイスのインストール、PnP フィルター ドライバーのインストール、レジストリでのユーザーアクセス可能なデバイス固有のドライバーに依存しない情報の設定に使用されます。明示的な AddReg ディレクティブを使用する場合も 、Include エントリと Needs エントリを使用する場合も同様です。
[install-section-name.HW] |
[install-section-name.nt.HW] |
[install-section-name.ntx86.HW] |
[install-section-name.ntia64.HW] | (Windows XP and later versions of Windows)
[install-section-name.ntamd64.HW] | (Windows XP and later versions of Windows)
[install-section-name.ntarm.HW] | (Windows 8 and later versions of Windows)
[install-section-name.ntarm64.HW] (Windows 10 version 1709 and later versions of Windows)
[AddReg=add-registry-section[,add-registry-section]...] ...
[Include=filename.inf[,filename2.inf]...]
[Needs=inf-section-name[,inf-section-name]...]
[DelReg=del-registry-section[,del-registry-section]...] ...
[BitReg=bit-registry-section[,bit-registry-section] ...]
エントリ
ユニバーサル INF では、すべての有効なエントリがサポートされているわけではありません。 次に、ユニバーサル INF で有効なディレクティブと有効でないディレクティブを示します。
ユニバーサル INF でサポートされる
AddReg=add-registry-section[,add-registry-section]...
この DDInstall の対象となるデバイスについて、INF ファイル内の別の場所にある 1 つ以上の INF ライター定義の add-registry-section を参照します。HW セクション。
add-registry セクションは、通常、フィルターをインストールしたり、デバイスごとの情報をレジストリに格納したりします。 このような add-registry セクションの HKR 仕様では、デバイスのハードウェア キー (デバイスに関する情報を含むデバイス固有のレジストリ サブキー) を指定します。 ハードウェア キーは、デバイス キーとも呼ばれます。 詳細については、「 デバイスとドライバーのレジストリ ツリーとキー」を参照してください。 ドライバー パッケージは、DDInstall.HW セクションによって参照される add-registry セクションの HKR 仕様を使用して、INF を介して設定を追加できます。
詳細については、「 INF AddReg ディレクティブ」を参照してください。
Include=filename。inf[,filename2.inf]...
このデバイスをインストールするために必要なセクションを含む 1 つ以上のシステム提供 INF ファイルを指定します。 このエントリが指定されている場合、通常は Needs エントリも指定されます。
Needs=inf-section-name[,inf-section-name]...
このデバイスのインストール時に処理する必要がある名前付きセクションを指定します。 通常、このような名前付きセクションは DDInstall です。インクルード エントリに一覧表示されているシステム提供の INF ファイル内の HW セクション。 ただし、このような DDInstall 内で参照される任意のセクションを指定できます。含まれている INF の HW セクション。
ユニバーサル INF ではサポートされていません
DelReg=del-registry-section[,del-registry-section]...
この DDInstall セクションの対象となるデバイスのドライバーについて、INF ファイル内の 1 つ以上の INF ライター定義 delete-registry-sectionを参照します。 このような delete-registry セクションは、以前にインストールされたデバイス/ドライバーの古いレジストリ情報をターゲット コンピューターから削除します。 このような delete-registry セクションの HKR 仕様は、 AddReg と同じサブキーを指定します。
このディレクティブは、この DDInstall セクションの名前を定義した製造元ごとのモデルのセクションに記載されているのと同じデバイス/モデルの以前のインストールをアップグレードする INF ファイルを除き、ほとんど使用されません。 詳細については、「 INF DelReg ディレクティブ」を参照してください。
BitReg=bit-registry-section[,bit-registry-section] ...
このセクションでは有効ですが、ほとんど使用されません。 参照されるビット レジストリ セクションの HKR 仕様は、 AddReg と同じサブキーを指定します。 詳細については、「 INF BitReg ディレクティブ」を参照してください。
Remarks
正式な構文ステートメントに示されている install-section-name の大文字と小文字を区別しない拡張は、このような DDInstall に挿入できます。クロスプラットフォーム INF ファイルの HW セクション名。 システム定義の .nt、.ntx86、.ntia64、.ntamd64、.ntarm、および .ntarm64 拡張機能の使用方法の詳細については、「複数のプラットフォームとオペレーティング システム用の INF ファイルの作成」を参照してください。
任意の DDInstall。HW セクションには、次のいずれかが必要です。
- AddReg ディレクティブ。
- 別の INF ファイルを指定する Include エントリ。 この場合は DDInstall です。HW セクションには、他の INF ファイル内のセクションを指定する対応する Needs エントリも含まれている必要があります。 このセクションは、必要なレジストリ情報を設定するために使用されます。
DDInstall 内の各ディレクティブ。HW セクションは、複数の INF ライター定義セクションを参照できます。 ただし、追加の名前付きセクションはそれぞれ、コンマ (,) で区切る必要があります。
このような各セクション名は、INF ファイル内で一意である必要があり、セクション名を定義するための一般的な規則に従う必要があります。 これらの規則の詳細については、「 INF ファイルの一般的な構文規則」を参照してください。
多機能デバイスのインストール方法の詳細については、「多機能デバイスの サポート」を参照してください。
Examples
この例では、ドライバー パッケージで DDInstall を使用する方法を示します。HW セクションと DDInstall。関数ドライバーと PnP 上位フィルター ドライバーの両方を追加するサービス セクション。
[Example_DDInstall]
CopyFiles=example_copyfiles
[Example_DDInstall.HW]
AddReg=filter_addreg
[filter_addreg]
HKR,,"UpperFilters",0x00010000,"ExampleUpperFilter" ; [REG_MULTI_SZ](https://learn.microsoft.com/windows/desktop/SysInfo/registry-value-types) value
[Example_DDInstall.Services]
AddService=ExampleFunctionDriver,0x00000002,function_ServiceInstallSection
AddService=ExampleUpperFilter,,filter_ServiceInstallSection
[function_ServiceInstallSection]
DisplayName = %function_ServiceDesc%
ServiceType = 1
StartType = 3
ErrorControl = 1
ServiceBinary = %13%\ExampleFunctionDriver.sys
[filter_ServiceInstallSection]
DisplayName = %filter_ServiceDesc%
ServiceType = 1
StartType = 3
ErrorControl = 1
ServiceBinary = %13%\ExampleUpperFilter.sys