INF DelProperty ディレクティブ
注意事項
ユニバーサル または Windows ドライバー パッケージをビルドする場合、このディレクティブは無効です。 「ユニバーサル INF ファイルを使用する」および「Windows ドライバーの開発の概要」を参照してください。
DelProperty 命令は、デバイス・インスタンス、 デバイス・セットアップ・クラス、 デバイス インターフェース クラス、またはデバイス インターフェースの デバイス プロパティ を削除する1つ以上のINFファイル セクションを参照します。
[DDInstall] |
[DDInstall.CoInstallers] |
[ClassInstall32] |
[ClassInstall32.ntx86] |
[ClassInstall32.ntia64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntamd64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntarm] | (Windows 8 and later versions of Windows)
[ClassInstall32.ntarm64] | (Windows 10 version 1709 and later versions of Windows)
[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 version 1709 and later versions of Windows)
[add-interface-section]
DelProperty=del-property-section[,del-property-section]... (Windows Vista and later versions of Windows)
DelProperty ディレクティブは、上記の正式な構文ステートメントに示されているセクションのいずれかで指定できます。
DelProperty ディレクティブによって参照される del-property-section の形式は次のとおりです。
[del-property-section]
(property-name [ ,, flags [, value]]) | ({property-category-guid}, property-pid [ , flags [, value]])
(property-name [ ,, flags [, value]]) | ({property-category-guid}, property-pid [ , flags [, value]])
...
add プロパティ セクション には、それぞれ個別の行に、任意の数の プロパティ名 エントリまたは プロパティ-guid エントリを含めることができます。
Entries
property-name
デバイス インスタンス ドライバー パッケージ のプロパティを表すいずれかのプロパティ名。 サポートされているプロパティ名は、 INF AddProperty ディレクティブの プロパティ名 エントリで説明されているものと同じです。
property-category-guid
プロパティ カテゴリを識別する GUID 値。 GUID 値には、システム定義のプロパティ カテゴリを識別するシステム定義 GUID、またはカスタム プロパティ カテゴリを識別するカスタム GUID を指定できます。 サポートされている GUID 値は、INF AddProperty ディレクティブの property-category-guid エントリに記述されているものと同じです。
property-pid
property-category-guid 値によって示されるプロパティ カテゴリ内の特定のプロパティを示すプロパティ識別子。 内部システム上の理由から、プロパティ識別子は 2 またはそれ以上である必要があります。
flags
削除操作を制御する省略可能な 16 進フラグ値。 サポートされているフラグ値は次のとおりです。
0x00000001 (FLG_DELPROPERTY_MULTI_SZ_DELSTRING)
プロパティのデータ型が DEVPROP_TYPE_STRING_LIST場合、操作は、値の入力値によって指定された文字列と一致する既存の文字列リストを持つすべての文字列を削除します。 文字の大文字と小文字は、指定された文字列と文字列リスト内の既存の文字列の比較では考慮されません。
value
プロパティ のデータ型がDEVPROP_TYPE_STRING_LISTされ、フラグ エントリが 0x00000001されている場合、 値 エントリの値は、既存の文字列リスト内の一致する文字列を検索するために削除操作が使用する文字列を提供し、一致する文字列が見つかった場合、削除操作は既存の文字列リストから一致する文字列を削除します。
解説
一般に、INF ファイルは、システム コンポーネントまたは別の INF ファイルによって設定される可能性があるデバイス プロパティを削除するために使用しないでください。 DelProperty ディレクティブの主な目的は、以前のデバイスのインストールを更新する INF ファイルで使用するためであり、以前のデバイスのインストールに設定されたプロパティは不要になりました。
del-property-section 名は INF ファイル内で一意である必要がありますが、セクション名は同じ INF ファイル内の複数の DelPropertyディレクティブによって参照できます。 セクション名は、 INF ファイルの一般的な構文規則で説明されているセクション名を定義するための一般的な規則に従う必要があります。
DelProperty ディレクティブの使用方法の詳細については、「INF AddProperty ディレクティブと INF DelProperty ディレクティブの使用」を参照してください。
例
次の delete プロパティ セクションの例には、2 つの行エントリが含まれています。最初の行エントリには、 DeviceModel プロパティを削除する プロパティ名 エントリ値が含まれており、2 行目のエントリは、データ型がDEVPROP_TYPE_STRING_LISTカスタム デバイス プロパティ値から文字列 "DeleteThisString" を削除します。 2 行目の property-category-guid のエントリ値は "c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e" で、 property-identifier のエントリ値は "2"、 flags エントリ値は "0x00000001" です。
[SampleDelPropertySection]
DeviceModel
{c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e}, 2, 0x00000001, "DeleteThisString"