INF ディレクティブの概要

次の一覧は、INF ファイルで使用できるディレクティブの多く (ただし、すべてではありません) をまとめたものです。 INF ディレクティブ名では大文字と小文字は区別されません。 たとえば、AddregaddRegAddReg は INF ファイル内のディレクティブ仕様と同じように有効です。

このセクションでは、最も一般的に使用されるディレクティブを、相互または関連するディレクティブと共に最初に示します。 ほとんど使われないディレクティブは、リストの最後の方にあります。

IAddReg ディレクティブ
このディレクティブは、1 つ以上 の add-registry-section を参照します。これは、レジストリ内のサブキーと値エントリを追加または変更するために使用される INF セクションです。

AddReg ディレクティブが存在する特定の INF セクションによって、参照先の add-registry-section で指定された変更を受け取る既定の相対レジストリの場所が決まります。 これらの既定のレジストリの場所は、通常、デバイス固有またはドライバー固有のサブキーです。

追加の add-registry-sections では、上位レベルのドライバーにエクスポートされたシステム定義デバイス インターフェイス (カーネル ストリーミング インターフェイスなど) のレジストリ情報、特定のデバイス クラスのインストール済みコンポーネントによってエクスポートされた新しいデバイス インターフェイス、またはドライバー サービスのレジストリ情報を設定できます。

CopyFiles ディレクティブ
このディレクティブは、モデル/デバイス固有のドライバー イメージとその他の必要なファイルを配布メディアから各ファイルの宛先ディレクトリに転送することを指定する 1 つ以上の file-list-section を参照します。

AddService ディレクティブ
このディレクティブは、少なくとも service-install-section を参照します。場合によっては、追加 の event-log-install-section を使用します。

ほとんどの種類のデバイスのINFファイル(ドライバをインストールするもの)には、INF ライター定義の service-install-section があり、システムが提供するドライバーやサービスへのシステムの初期化処理のどの段階で、提供されたドライバーを読み込むか、など依存関係を指定します。 デバイス ドライバーの多くの INF ファイルには、デバイス ドライバーによるイベント ログを設定するために AddService ディレクティブによって参照される INF ライター定義の event-log-install-section もあります。

AddInterface ディレクティブ
このディレクティブは、このデバイス/ドライバーでサポートされているデバイス インターフェイスのレジストリ エントリを設定するセクションを参照する 1 つ以上の AddReg ディレクティブが指定されている add-interface-sectionを参照します。

DelReg ディレクティブ
注: ユニバーサル ドライバー または "Windows ドライバー" ドライバー パッケージをビルドする場合、このディレクティブは無効です。 「ユニバーサル INF ファイルの使用」を参照してください。

このディレクティブは、古いサブキーや値エントリをレジストリから削除するために使用される 1 つ以上 の del-registry-section を参照します。 たとえば、このようなセクションは、以前のインストールをアップグレードする INF に表示される場合があります。

DelFiles ディレクティブ
注: ユニバーサル ドライバー または "Windows ドライバー" ドライバー パッケージをビルドする場合、このディレクティブは無効です。 「ユニバーサル INF ファイルの使用」を参照してください。

この使用頻度の低いディレクティブは、インストールのターゲットから削除するファイルを指定する 1 つ以上の file-list-section を参照します。

DelService ディレクティブ
注: ユニバーサル ドライバー または "Windows ドライバー" ドライバー パッケージをビルドする場合、このディレクティブは無効です。 「ユニバーサル INF ファイルの使用」を参照してください。

この使用頻度の低いディレクティブは、以前にインストールされたサービスを削除します。

LogConfig ディレクティブ
注: ユニバーサル ドライバー または "Windows ドライバー" ドライバー パッケージをビルドする場合、このディレクティブは無効です。 「ユニバーサル INF ファイルの使用」を参照してください。

このディレクティブは、(PnP デバイス列挙子によって) 検出されたデバイスまたは手動でインストールされたデバイスの INF で許容されるバス相対およびデバイス固有のハードウェア構成を指定する 1 つ以上 の log-config-section を参照します。 たとえば、手動でインストールされている 非 PnP の ISA、EISA、MCA デバイスの INF ファイルは、このディレクティブを使用します。 (INF DDInstall.LogConfigOverride セクションも参照してください)。