INF InterfaceInstall32 セクション
このセクションでは、1 つ以上の新しい デバイス インターフェイス クラスを作成します。 新しいクラスが作成されると、後でインストールされたデバイス/ドライバーは、 IoRegisterDeviceInterfaceを呼び出すことによって、新しいデバイス インターフェイス クラスのサポートを登録できます。
[InterfaceInstall32]
{InterfaceClassGUID}=install-interface-section[,flags]
...
エントリ
InterfaceClassGUID
新しくエクスポートされた デバイス インターフェイス クラスを識別する GUID 値を指定します。
インターフェイス クラスのインスタンスを登録するには、デバイスのドライバーがこの GUID で IoRegisterDeviceInterface を呼び出す必要があります。 このセクションで指定した GUID 値は、 INF DDInstall.Intrefaces セクション の INF AddInterface ディレクティブ でも参照できます。
GUID を作成する方法の詳細については、「ドライバーでの GUID の使用」を参照してください。 システム定義インターフェイス クラス GUID については、カーネル ストリーミング インターフェイス の Ks.h などの適切なヘッダーを参照してください。
install-interface-section
INF ライター定義セクションを参照します。場合によっては、この INF の他の場所にあるシステム定義の拡張機能を使用します。
flags
指定する場合、このエントリは 0 である必要があります。
解説
指定した InterfaceClassGUID がシステムにまだインストールされていない場合、デバイスのインストール中、またはデバイスのドライバが IoRegisterDeviceInterfaceを最初に呼び出したときに、対応する DDInstall.Interfaces セクションが処理されるときに、そのインターフェイス クラスがインストールされます。
install-interface-section 名はそれぞれ INFファイル内で一意であり、セクション名を定義するための一般的な規則に従う必要があります。 これらの規則の詳細については、「INF ファイルの一般的な構文規則」を参照してください。
指定した install-interface-section には、次の一般的な形式があります。
[interface-install-section] |
[interface-install-section.nt] |
[interface-install-section.ntx86] |
[interface-install-section.ntia64] | (Windows XP and later versions of Windows)
[interface-install-section.ntamd64] | (Windows XP and later versions of Windows)
[interface-install-section.ntarm] | (Windows 8 and later versions of Windows)
[interface-install-section.ntarm64] (Windows 10 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)
[Copyfiles=@filename | 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)
[BitReg=bit-registry-section[,bit-registry-section]...]
[Delfiles=file-list section[, file-list-section] ...]
[Renfiles=file-list-section[, file-list-section] ...]
[UpdateInis=update-ini-section[,update-ini-section]...]
[UpdateIniFields=update-inifields-section[,update-inifields-section]...]
[Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...]
...
interface-install-section のエントリの詳細については、 INF DDInstall セクションを参照してください。
Windows Vista 以降では、 INF AddProperty directives を add-interface セクションに含めることで、 デバイス インターフェイス クラス のプロパティを設定できます。 インターフェイス インストール セクションに INF DelProperty ディレクティブ を含めることで、デバイス インターフェイス クラスのプロパティを削除することもできます。 ただし、 AddProperty ディレクティブまたは DelProperty ディレクティブは、Windows Vista 以降のバージョンの Windows オペレーティング システムを初めて使用するデバイス インターフェイス クラスのプロパティを変更する場合にのみ使用してください。 Windows Server 2003、Windows XP、または Windows 2000 で導入され、対応するレジストリ値エントリを持つデバイス インターフェイス プロパティの場合は、引き続き INF AddReg directives と INF DelReg directives を使用して、デバイス インターフェイス クラスのプロパティを設定および削除する必要があります。 これらのガイドラインは、システム定義のプロパティとカスタム プロパティに適用されます。 AddProperty ディレクティブと DelProperty ディレクティブの使用方法の詳細については、「INF AddProperty ディレクティブと INF DelProperty ディレクティブの使用」を参照してください。
AddReg ディレクティブは、このインターフェイスのインストール中にレジストリにデバイス インターフェイス固有の情報を設定する 1 つ以上の add-registry セクションを参照します。
このインターフェイス クラスに関するレジストリ情報には、少なくとも新しい デバイス インターフェイス クラス のフレンドリ名と、上位レベルのコンポーネントがこのインターフェイスを開いて使用するときに必要な情報が含まれている必要があります。
さらに、このような install-interface-section では、次に示す任意のディレクティブを使用して、インターフェイス固有のインストール操作を指定できます。
システム定義の .nt, .ntx86, .ntia64, .ntamd64, .ntarmおよび .ntarm64 の拡張機能の使用方法の詳細については、「複数のプラットフォームとオペレーティング システム用の INF ファイルの作成」を参照してください。