注記
ユニバーサル ドライバー パッケージをビルドする場合、このセクションはアーキテクチャの装飾 ([DefaultInstall.NTAMD64] など) がある場合にのみ有効です。
注記
INF で DefaultInstall セクションと Manufacturer セクションの両方を使用すると、ユニバーサル INF 検証エラーが発生し、一貫性のないインストール動作が発生する可能性があります。 ユニバーサル INF ファイルの使用を参照してください。
INF ファイル名を選択して保持 (または右クリック) した後、ユーザーが [インストール] メニュー項目を選択すると、INF ファイルの DefaultInstall セクションにアクセスします。 バージョン 1903 以降Windows 10バージョンのWindowsでは、プリミティブ ドライバーの要件を満たしている場合、DefaultInstall を含む INF を多くのドライバー パッケージ API で使用できます。
[DefaultInstall] |
[DefaultInstall.nt] |
[DefaultInstall.ntx86] |
[DefaultInstall.ntia64] | (Windows XP and later versions of Windows)
[DefaultInstall.ntamd64] | (Windows XP and later versions of Windows)
[DefaultInstall.ntarm] | (Windows 8 and later versions of Windows)
[DefaultInstall.ntarm64] (Windows 10 version 1709 and later versions of Windows)
[CopyFiles=@filename | file-list-section[,file-list-section] ...]
[CopyINF=filename1.inf[,filename2.inf]...]
[AddReg=add-registry-section[,add-registry-section]...]
[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]...]
[BitReg=bit-registry-section[,bit-registry-section]...]
[ProfileItems=profile-items-section[,profile-items-section]...]
[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]...] ...
エントリ
ユニバーサル INF では、すべての有効なエントリがサポートされているわけではありません。 次に、ユニバーサル INF で有効なディレクティブと有効でないディレクティブを示します。
ユニバーサル INF でサポートされる
CopyFiles=@filename | file-list-section[,file-list-section] ...
この省略可能なディレクティブは、ソース メディアからコピー先にコピーする名前付きファイルを 1 つ指定するか、ソース メディアから転送先に転送するファイルを指定する 1 つ以上の INF ライター定義セクションを参照します。
INF の DestinationDirs セクションの DefaultDestDir エントリは、コピーする 1 つのファイルの宛先を指定します。 SourceDisksNames セクションと SourceDisksFiles セクション、またはこの INF のバージョン セクションの LayoutFile エントリで指定された追加の INF は、ドライバー ファイルの配布メディア上の場所を提供します。
詳細については、「 INF CopyFiles ディレクティブ」を参照してください。
CopyINF=filename1.inf[,filename2.inf]...
(Windows XP 以降のバージョンのWindows)。このディレクティブにより、指定した INF ファイルがターゲット システムにコピーされます。
詳細については、 INF CopyINF ディレクティブを参照してください。
AddReg=add-registry-section[,add-registry-section]...
このディレクティブは、新しいサブキー (場合によっては初期値エントリを含む) がレジストリに書き込まれるか、既存のキーの値エントリが変更されるように指定されている、1 つ以上の INF ライター定義セクションを参照します。
詳細については、「 INF AddReg ディレクティブ」を参照してください。
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) インクルード エントリに 一覧表示されている INF ファイルの 1 つ内のセクション。 ただし、このような DDInstall または DDInstall 内で参照される任意のセクションを指定できます。含まれている INF の xxx セクション。
たとえば、前の インクルード エントリを持つデバイス ドライバーの INF ファイルでは、次のようにこのエントリを指定します。
Needs= KS.Registration,KSCAPTUR.Registration.NT,MSPCLOCK.Installation
ユニバーサル 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 DelReg ディレクティブ」を参照してください。
BitReg=bit-registry-section[,bit-registry-section]...
このディレクティブは 、REG_BINARY型 の既存のレジストリ値エントリが変更される 1 つ以上の INF ライター定義セクションを参照します。 詳細については、「 INF AddReg ディレクティブ」を参照してください。
詳細については、「 INF BitReg ディレクティブ」を参照してください。
ProfileItems=profile-items-section[,profile-items-section]...
このディレクティブは、スタート メニューに追加または削除する項目を記述する 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 ディレクティブ」を参照してください。
Remarks
DefaultInstall セクションは、デバイスのインストールには使用しないでください。 DefaultInstall セクションは、デバイス ノード (devnode) に関連付けられていないクラス フィルター ドライバー、ファイル システム フィルター、カーネル ドライバー サービスのインストールにのみ使用します。
Windows 10 バージョン 1903 以降のバージョンの Windows で DefaultInstall を使用する場合は、INF ファイルがプリミティブ ドライバーの要件を満たしていることをお勧めします。
注記
ドライバー パッケージがデジタル署名される場合は、Manufacturer セクションを含むドライバー パッケージの INF ファイルに INF DefaultInstall セクションを含めてはなりません。 ドライバー パッケージの署名の詳細については、「 ドライバーの署名」を参照してください。
デバイス インストール アプリケーションから DefaultInstall セクションを インストールするには、 InstallHinfSection の次の呼び出しを使用します。
InstallHinfSection(NULL,NULL,TEXT("DefaultInstall 132 path-to-inf\infname.inf"),0);
システム定義の .nt、.ntx86、.ntia64、.ntamd64、.ntarm、および .ntarm64 拡張機能の使用方法の詳細については、「複数のプラットフォームとオペレーティング システム用の INF ファイルの作成」を参照してください。
Examples
次の例は、一般的な DefaultInstall セクションを示しています。
[DefaultInstall]
CopyFiles=MyAppWinFiles, MyAppSysFiles, @SRSutil.exe
AddReg=MyAppRegEntries