INF InterfaceInstall32 セクション

このセクションでは、1 つ以上の新しい デバイス インターフェイス クラスを作成します。 新しいクラスが作成された後、インストールされたデバイス/ドライバーは 、IoRegisterDeviceInterface を呼び出すことによって、新しいデバイス インターフェイス クラスのサポートを登録できます。

[InterfaceInstall32]
 
{InterfaceClassGUID}=install-interface-section[,flags]
...

エントリ

InterfaceClassGUID
新しくエクスポートされた デバイス インターフェイス クラスを識別する GUID 値を指定します。

インターフェイス クラスのインスタンスを登録するには、デバイスのドライバーがこの GUID で IoRegisterDeviceInterface を呼び出す必要があります。 このセクションで指定した GUID 値は、INF DDInstall の INF AddInterface ディレクティブでも参照できます。[インターフェイス] セクション。

GUID を作成する方法の詳細については、「 ドライバーでの GUID の使用」を参照してください。 システム定義インターフェイス クラス GUID については、カーネル ストリーミング インターフェイスの Ks.h などの適切なヘッダーを参照してください。

install-interface-section
INF ライター定義セクションを参照します。場合によっては、この INF の他の場所にあるシステム定義の拡張機能を使用します。

フラグ
指定する場合、このエントリは 0 である必要があります。

Remarks

指定した InterfaceClassGUID がまだシステムにインストールされていない場合、そのインターフェイス クラスは対応する DDInstall としてインストールされます。Interfaces セクションは、デバイスのインストール中、またはそのデバイスのドライバーが IoRegisterDeviceInterface への最初の呼び出しを行うときに処理されます。

各 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 ディレクティブを含めることで、デバイス インターフェイス クラスのプロパティを設定できます。 インターフェイス インストール セクションに INF DelProperty ディレクティブ を含めることで、デバイス インターフェイス クラスのプロパティを削除することもできます。 ただし、AddProperty または DelProperty ディレクティブは、Windows Vista以降のバージョンのオペレーティング システムに初めて使用するデバイス インターフェイス クラスのプロパティを変更する場合にのみ使用Windows必要があります。 Windows Server 2003、Windows XP、または 2000 Windows 2000 で導入され、対応するレジストリ値エントリを持つデバイス インターフェイス クラスのプロパティの場合は、引き続き INF AddReg ディレクティブと INF DelReg ディレクティブを使用して、デバイス インターフェイス クラスのプロパティを設定および削除する必要があります。 これらのガイドラインは、システム定義のプロパティとカスタム プロパティに適用されます。 AddProperty ディレクティブと DelProperty ディレクティブの使用方法の詳細については、「INF AddProperty ディレクティブと INF DelProperty ディレクティブの使用」を参照してください。

AddReg ディレクティブは、このインターフェイスのインストール中にレジストリにデバイス インターフェイス固有の情報を設定する 1 つ以上の add-registry セクションを参照します。

このインターフェイス クラスに関するレジストリ情報には、新しい デバイス インターフェイス クラス のフレンドリ名と、上位レベルのコンポーネントがこのインターフェイスを開いて使用するときに必要な情報が少なくとも含まれている必要があります。

さらに、このような install-interface-section では、次に示す任意のディレクティブを使用して、インターフェイス固有のインストール操作を指定できます。

システム定義の .nt、.ntx86、.ntia64、.ntamd64、.ntarm、.ntarm64 拡張機能の使用方法の詳細については、「複数のプラットフォームとオペレーティング システム用の INF ファイルの作成」を参照してください。

参照

AddProperty

AddReg

BitReg

ClassInstall32

CopyFiles

DDInstall

DDInstall。インターフェイス

DelFiles

DelProperty

DelReg

Ini2Reg

IoRegisterDeviceInterface

RenFiles

UpdateIniFields

UpdateInis