INF DDInstall セクション
各モデル
これらのディレクティブによって参照されるセクションには、ドライバー ファイルをインストールし、デバイス固有の情報やドライバー固有の情報をレジストリに書き込むための手順が含まれています。
[install-section-name] |
[install-section-name.nt] |
[install-section-name.ntx86] |
[install-section-name.ntia64] | (Windows XP and later versions of Windows)
[install-section-name.ntamd64] | (Windows XP and later versions of Windows)
[install-section-name.ntarm] | (Windows 8 and later versions of Windows)
[install-section-name.ntarm64] (Windows 10 version 1709 and later versions of Windows)
[DriverVer=mm/dd/yyyy[,x.y.v.z]]
[CopyFiles=@filename | file-list-section[,file-list-section] ...]
[CopyINF=filename1.inf[,filename2.inf]...] (Windows XP and later versions of Windows)
[AddReg=add-registry-section[,add-registry-section]...]
[AddProperty=add-property-section[,add-property-section]...] (Windows Vista and later versions of Windows)
[Include=filename1.inf[,filename2.inf]...]
[Needs=inf-section-name[,inf-section-name]...]
[Delfiles=file-list-section[,file-list-section]...]
[Renfiles=file-list-section[,file-list-section]...]
[DelReg=del-registry-section[,del-registry-section]...]
[DelProperty=del-property-section[,del-property-section]...] (Windows Vista and later versions of Windows)
[FeatureScore=featurescore]... (Windows Vista and later versions of Windows)
[BitReg=bit-registry-section[,bit-registry-section]...]
[LogConfig=log-config-section[,log-config-section]...]
[ProfileItems=profile-items-section[,profile-items-section]...] (Windows 2000 and later versions of Windows)
[UpdateInis=update-ini-section[,update-ini-section]...]
[UpdateIniFields=update-inifields-section[,update-inifields-section]...]
[Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...]
[RegisterDlls=register-dll-section[,register-dll-section]...]
[UnregisterDlls=unregister-dll-section[,unregister-dll-section]...]
[ExcludeID=device-identification-string[,device-identification-string]...]... ((Windows XP and later versions of Windows)
[Reboot]
エントリ
ユニバーサル INFでは、すべての有効なエントリがサポートされているわけではありません。 次に、ユニバーサル INF で有効なディレクティブと有効でないディレクティブを示します。
ユニバーサル INF でサポートされる
DriverVer=mm/dd/yyyy[,x.y.v.z]
この省略可能なエントリは、ドライバー パッケージのバージョン情報を指定します。
このエントリを指定する方法については、「INF DriverVer ディレクティブ を参照してください。
CopyFiles=@ファイル名 | file-list-section[,file-list-section] ...
このディレクティブは、ソース メディアからコピー先にコピーする名前付きファイルを 1 つ指定するか、またはソース メディア上のデバイス関連ファイルを転送先に指定する 1 つ以上の INF ライター定義セクションを参照します。
INF の DestinationDirs セクションの DefaultDestDir エントリは、コピーする 1 つのファイルのコピー先を指定します。 SourceDisksNames および SourceDisksFiles セクション、またはこの INF の Version セクションの LayoutFile エントリで指定された追加の INF は、ドライバー ファイルの配布メディア上の場所を指定します。
詳細については、INF CopyFiles ディレクティブ
CopyINF=filename1.inf[,filename2.inf]...
(Windows XP 以降)このディレクティブにより、指定した INF ファイルがターゲット システムにコピーされます。
詳細については、INF CopyINF ディレクティブ
AddReg=add-registry-section[,add-registry-section]...
このディレクティブは、新しいサブキー (場合によっては初期値エントリを含む) がレジストリに書き込まれるか、既存のキーの値エントリが変更されるように指定されている、1 つ以上の INF ライター定義セクションを参照します。
このような add-registry セクションの
詳細については、INF AddReg ディレクティブ
AddProperty=add-property-section[,add-property-section]...
(Windows Vista 以降)デバイス インスタンスに設定
Windows Server 2003、Windows XP、または Windows 2000 で以前に導入され、対応するレジストリ エントリ値を持つデバイス インスタンス プロパティの場合は、デバイス インスタンスのプロパティを設定するために
Include=filename1.inf[,filename2.inf]...
この省略可能なエントリは、このデバイスやドライバーをインストールするために必要なセクションを含む 1 つ以上のシステム提供 INF ファイルを指定します。 このエントリが指定されている場合、通常は Needs エントリも同じになります。
たとえば、システムのカーネル ストリーミング サポートに依存するデバイス ドライバーの INF ファイルでは、次のようにこのエントリを指定できます。
Include= ks.inf, kscaptur.inf, ksfilter.inf
Needs=inf-section-name[,inf-section-name]...
この省略可能なエントリは、このデバイスのインストール中に処理する必要がある、システム提供の INF ファイル内のセクションを指定します。 通常、このような名前付きセクションは、DDInstall (または DDInstall.xxx) セクションで、Include エントリに一覧表示されている INF ファイルの 1 つ内にあります。 ただし、このような
たとえば、上記の Include エントリを持つデバイス ドライバーの INF ファイルでは、次のようにこのエントリを指定できます。
Needs= KS.Registration, KSCAPTUR.Registration.NT, MSPCLOCK.Installation
FeatureScore=featurescore
警告
FeatureScore ディレクティブは、[DDInstall] セクションで直接指定した場合にのみ処理されます。
(Windows Vista 以降)このディレクティブは、ドライバーがサポートする機能に基づくドライバーの追加のランク付け基準を提供します。 たとえば、機能スコアは、クラス固有の条件に基づいてドライバーを区別する
ドライバーのランク付け方法の詳細については、「Windows によるドライバーのランク付け方法 (Windows Vista 以降)を参照してください。
このディレクティブの詳細については、INF FeatureScore ディレクティブ
手記
ExcludeID=device-identification-string[,device-identification-string]...
警告
ExcludeID ディレクティブは、[DDInstall] セクションで直接指定した場合にのみ処理されます。
(Windows XP 以降)このディレクティブは、1 つ以上のデバイス識別文字列 (
再起動
このディレクティブは、インストールが完了した後、呼び出し元にシステムの再起動を求めるメッセージを表示することを示します。
詳細については、「INF Reboot Directive」を参照してください。
ユニバーサル INF ではサポートされていません
Delfiles=file-list-section[,file-list-section]...
このディレクティブは、削除するターゲット上のファイルを一覧表示する 1 つ以上の INF ライター定義セクションを参照します。
詳細については、「INF DelFiles ディレクティブを
Renfiles=file-list-section[,file-list-section]...
このディレクティブは、デバイス関連のソース ファイルがターゲット コンピューターにコピーされる前に、コピー先で名前を変更するファイルを一覧表示する 1 つ以上の INF ライター定義セクションを参照します。
詳細については、「INF RenFiles ディレクティブの
DelReg=del-registry-section[,del-registry-section]...
このディレクティブは、デバイスのインストール中にキーや値のエントリをレジストリから削除するように指定されている 1 つ以上の INF ライター定義セクションを参照します。
通常、このディレクティブは、INF がこのデバイスの以前のインストールから古いレジストリ エントリをクリーンアップする必要がある場合にアップグレードを処理するために使用されます。
このような削除レジストリ セクションの
詳細については、INF DelReg ディレクティブ
DelProperty=del-property-section[,del-property-section]...
(Windows Vista 以降)デバイス インスタンスに設定 デバイス プロパティ
Windows Server 2003、Windows XP、または Windows 2000 で以前に導入され、対応するレジストリ エントリ値を持つデバイス インスタンス プロパティの場合は、デバイス インスタンスのプロパティを削除
BitReg=bit-registry-section[,bit-registry-section]...
このディレクティブは、REG_BINARY 型の既存のレジストリ値エントリが変更される 1 つ以上の INF ライター定義セクションを参照します。
このようなビット レジストリ セクションの
詳細については、INF BitReg ディレクティブ
LogConfig=log-config-section[,log-config-section]...
このディレクティブは、ルート列挙デバイスまたは手動でインストールされたデバイスの INF 内の 1 つ以上の INF ライター定義セクションを参照します。 これらの名前付きセクションでは、このような "検出" または手動でインストールされたデバイスの INF によって、デバイスが動作する必要があるバス相対ハードウェア リソースの 1 つ以上の論理構成が指定されます。 ソフトウェアで構成できない手動でインストールされたデバイスの INF にも、DDInstallが必要です。FactDef セクション。
LogConfig ディレクティブは、プラグ アンド プレイ (PnP) デバイスのインストールには使用されません。 ただし、INF DDInstall.LogConfigOverride セクション を使用して、PnP デバイスのオーバーライド構成を提供できます。
このディレクティブは、上位レベル (非デバイス) のすべてのドライバーとコンポーネントとは無関係です。
詳細については、INF LogConfig ディレクティブ
ProfileItems=profile-items-section[,profile-items-section]...
(Microsoft Windows 2000 以降のバージョンの Windows)この使用頻度の低いディレクティブは、[スタート] メニューに追加または削除する項目を記述する 1 つ以上の INF ライター定義セクションを参照します。
詳細については、INF ProfileItems ディレクティブ
UpdateInis=update-ini-section[,update-ini-section]...
この使用頻度の低いディレクティブは、1 つ以上の INF ライター定義セクションを参照します。このセクション内の特定のセクションまたは行をインストール時に同じ名前の宛先 INI ファイルに読み込むソース INI ファイルを指定します。 必要に応じて、同じ名前の特定のソース INI ファイルからコピー先の既存の INI ファイルに対する行単位の変更を update-ini セクションで指定できます。
詳細については、「INF UpdateInis ディレクティブ」を参照してください。
UpdateIniFields=update-inifields-section[,update-inifields-section]...
この使用頻度の低いディレクティブは、デバイス固有の INI ファイルの行内で変更が指定されている 1 つ以上の INF ライター定義セクションを参照します。
詳細については、INF UpdateIniFields ディレクティブ
Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...
この使用頻度の低いディレクティブは、ソース メディアで提供されるデバイス固有の INI ファイルのセクションまたは行をレジストリに移動する 1 つ以上の INF ライター定義セクションを参照します。
詳細については、INF Ini2Reg ディレクティブ
RegisterDlls=register-dll-section[,register-dll-section]...
このディレクティブは、OLE コントロールであり、自己登録が必要なファイルを指定するために使用される 1 つ以上の INF セクションを参照します。
詳細については、INF RegisterDlls ディレクティブ
UnregisterDlls=unregister-dll-section[,unregister-dll-section]...
このディレクティブは、OLE コントロールであり、自己登録解除 (自己削除) を必要とするファイルを指定するために使用される 1 つ以上の INF セクションを参照します。
詳細については、INF UnregisterDlls ディレクティブ
備考
Windows Driver Kit (WDK) のドキュメント全体を通じて、DDInstall
各 DDInstall セクションは、INF ファイルの [INF Models] セクション 製造元ごとのデバイス/モデル固有のエントリで参照 必要があります。
ソース メディアから転送するファイルが関連付けられていないデバイスを除き、異なるオペレーティング システム プラットフォームに WDM ドライバーをインストールする INF ファイルには、次の DDInstall セクションの少なくとも 1 つが必要です。
- x86 ベースのプラットフォームに固有のデバイス/ドライバーインストールのエントリを指定する .ntx86 セクション
インストール セクション名。 - install-section-name.ntia64 セクション。Itanium ベースのプラットフォームに固有のデバイス/ドライバーのインストールのエントリを指定します。
- x64 ベースのプラットフォームに固有のデバイス/ドライバーのインストールのエントリを指定する 、.ntamd64 セクション
インストール セクション名。 - install-section-name.ntarm セクションで、Arm ベースのプラットフォームに固有のデバイス/ドライバーのインストールのエントリを指定します。
- arm64 ベースのプラットフォームに固有のデバイス/ドライバーのインストールのエントリを指定する .ntarm64 セクション
インストール セクション名。 - install-section-name または install-section-name.nt セクション。特定のハードウェア プラットフォームに固有ではないデバイス/ドライバーのインストールのエントリを指定します。
システム定義 .nt、.ntx86、.ntia64、.ntamd64、.ntarm、および .ntarm64 拡張機能の使用方法の詳細については、 「複数のプラットフォームおよびオペレーティング システムの INF ファイルの作成を参照してください。
Windows 2000 以降では、ドライバーをインストールする INF ファイルには、ドライバー サービス情報を指定するために DDInstall.Services セクション
DDInstall セクション内の各ディレクティブは、複数のセクション名を参照できます。 ただし、追加の名前付きセクションはそれぞれ、コンマ (,) で区切る必要があります。
各セクション名は、INF ファイル内で一意である必要があり、セクション名を定義するための一般的な規則に従う必要があります。 これらの規則の詳細については、「INF ファイルの
DDInstall セクションで指定された AddReg ディレクティブは、上位または下位のフィルター ドライバー、多機能デバイス、またはドライバーに依存しないがデバイス固有のパラメーターに関する情報を格納するために使用できない追加レジストリ セクションを参照するものと見なされます。 デバイス/ドライバー INF がレジストリにこの種類の情報を格納する必要がある場合は、
INF バージョン セクションで指定された デバイス セットアップ クラスの に応じて、DDInstall セクションでクラス固有のディレクティブを追加指定できます。 クラス固有のディレクティブの詳細については、次のトピックを参照してください。
- Windows SideShow-Compatible デバイス 用の INF ファイルのビルドの
- ネットワーク INF ファイル の [DDInstall] セクションを
する - 静止画像デバイス用の INF ファイルの
- WIA デバイス 用の INF ファイルの
- ネットワーク コンポーネント の
インストール要件 - INF ファイルでの WDF ディレクティブの指定
例
この例では、DDInstall セクション、Ser_Inst セクション、および Inp_Instセクションの拡張を示します。 これらのセクションは、INF Models セクションの例で参照されています。
[Ser_Inst]
CopyFiles=Ser_CopyFiles, mouclass_CopyFiles
[Ser_CopyFiles]
sermouse.sys
[mouclass_CopyFiles] ; section name referenced by > 1 CopyFiles
mouclass.sys
[Inp_Inst]
CopyFiles=Inp_CopyFiles, mouclass_CopyFiles
[Inp_CopyFiles]
inport.sys
次の例は、さまざまなオペレーティング システム プラットフォームにオーディオ デバイス用のシステム提供 WDM ドライバーをインストールする INF ファイルの DDInstall セクションを示しています。
[WDMPNPB003_Device.NT]
Include=ks.inf, wdmaudio.inf
Needs=KS.Registration, WDMAUDIO.Registration.NT
CopyFiles=MSSB16.CopyList
AddReg=WDM_SB16.AddReg
次の例は、システム指定の
[KS.Registration]
; following AddReg= is actually a single line in the ks.inf file
AddReg=ProxyRegistration,CategoryRegistration,\
TopologyNodeRegistration,PlugInRegistration,PinNameRegistration,\
DeviceRegistration
CopyFiles=KSProxy.Files,KSDriver.Files
[WDMAUDIO.Registration.NT]
AddReg=WDM.AddReg
CopyFiles=WDM.CopyFiles.Sys, WDM.CopyFiles.Drv
;
; INF-writer-defined add-registry and file-list sections
; referenced by preceding directives are omitted here for brevity
;
関連項目
AddProperty の
DDInstallを
DDInstallを
DDInstallを
DDInstallを
DDInstallを
DDInstallを
DefaultInstall.Services の
FeatureScore の