INF DefaultInstall セクション
Note
ユニバーサル ドライバー パッケージ をビルドする場合、このセクションはアーキテクチャ装飾 ([DefaultInstall.NTAMD64] など) がある場合にのみ有効です。
Note
INF で DefaultInstall セクションと Manufacturer セクションの両方を使用すると、ユニバーサル INF 検証エラーが発生し、一貫性のないインストール動作が発生する可能性があります。 「ユニバーサル INF ファイルの使用」を参照してください。
INF ファイル名を選択して保持 (または右クリック) した後、ユーザーが [インストール] メニュー項目を選択すると、INF ファイルの DefaultInstall セクションにアクセスします。 Windows 10 バージョン 1903 以降のバージョンの 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 つ以上のシステム提供追加ァイルを指定します。 このエントリが指定されている場合、通常は Needs エントリも指定されます。
たとえば、システムのカーネル ストリーミング サポートに依存するデバイス ドライバーの システム INFでは、次のようにこのエントリを指定できます。
Include= ks.inf,kscaptur.inf,ksfilter.inf
Needs=inf-section-name[,inf-section-name]...
この省略可能なエントリは、このデバイスのインストール中に処理する必要がある、システム提供の INF ファイル内のセクションを指定します。 通常、このような名前のセクションは Include エントリーにリストされている INF ファイルの中の DDInstall (または DDInstall.xxx) セクションです。 ただし、含まれる INF の DDInstall または DDInstall.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 ディレクティブ」をご覧ください。
解説
DefaultInstall セクションは、デバイスのインストールには使用しないでください。 DefaultInstall セクションは、デバイス ノード (devnode) に関連付けられていないクラス フィルター ドライバー、ファイル システム フィルター、カーネル ドライバー サービスのインストールにのみ使用します。
Windows 10 バージョン 1903 以降のバージョンの Windows で DefaultInstall を使用する場合は、INF ファイルが プリミティブ ドライバーの要件を満たしていることをお勧めします。
Note
ドライバー パッケージ がデジタル署名される場合は、 Manufacturer セクションを含むドライバー パッケージの INF ファイルに INF DefaultInstall セクションを含めてはなりません。 ドライバー パッケージに署名する方法の詳細については、「ドライバーの署名」を参照してください。
Note
DDInstall セクションとは異なり、 DefaultInstall セクションには DriverVer ディレクティブまたは LogConfig ディレクティブを含めることはできません。
デバイス インストール アプリケーションから DefaultInstall セクションをインストールするには、 InstallHinfSection の次の呼び出しを使用します。
InstallHinfSection(NULL,NULL,TEXT("DefaultInstall 132 path-to-inf\infname.inf"),0);
システム定義の .nt, .ntx86, .ntia64, .ntamd64, .ntarm, および .ntarm64 の拡張機能の使用方法の詳細については、「複数のプラットフォームとオペレーティング システム用の INF ファイルの作成」を参照してください。
例
次の例は、通常の [DefaultInstall] セクションを示しています。
[DefaultInstall]
CopyFiles=MyAppWinFiles, MyAppSysFiles, @SRSutil.exe
AddReg=MyAppRegEntries