INF DelProperty-Direktive

Achtung

Wenn Sie ein universelles Oder Windows-Treiberpaket erstellen, ist diese Direktive ungültig. Weitere Informationen finden Sie unter Verwenden einer universellen INF-Datei und Erste Schritte mit Windows-Treibern.

Eine DelProperty-Direktive verweist auf einen oder mehrere INF-Dateiabschnitte, die Geräteeigenschaften für ein Gerät instance, eine Geräteeinrichtungsklasse, eine Geräteschnittstellenklasse oder eine Geräteschnittstelle löschen.

[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)

Eine DelProperty-Direktive kann in jedem der Abschnitte angegeben werden, die in der obigen formalen Syntax-Anweisung gezeigt werden.

Ein del-property-section , auf den von einer DelProperty-Direktive verwiesen wird, hat das folgende Format:

[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]])
...

Ein del-property-section kann eine beliebige Anzahl von Eigenschaftsnameneinträgen oder Property-GUID-Einträgen enthalten, die jeweils in einer separaten Zeile enthalten sind.

Einträge

Eigenschaftsname
Einer der Eigenschaftennamen, der die Eigenschaften des Gerätes instance Treiberpakets darstellt. Die unterstützten Eigenschaftennamen sind identisch mit denen, die für den Eigenschaftsnameneintrag der INF-AddProperty-Direktive beschrieben werden.

property-category-guid
Ein GUID-Wert, der die Eigenschaftenkategorie identifiziert. Der GUID-Wert kann eine systemdefinierte GUID sein, die eine systemdefinierte Eigenschaftenkategorie oder eine benutzerdefinierte GUID identifiziert, die eine benutzerdefinierte Eigenschaftenkategorie identifiziert. Die unterstützten GUID-Werte sind identisch mit denen, die für den Eintrag property-category-guid der INF AddProperty-Direktive beschrieben werden.

property-pid
Ein Eigenschaftsbezeichner, der die spezifische Eigenschaft innerhalb der Eigenschaftenkategorie angibt, die durch den Wert property-category-guid angegeben wird. Aus internen Systemgründen muss ein Eigenschaftsbezeichner größer oder gleich zwei sein.

flags
Ein optionaler Hexadezimalflagwert, der den Löschvorgang steuert. Der einzige unterstützte Flagwert ist wie folgt:

0x00000001 (FLG_DELPROPERTY_MULTI_SZ_DELSTRING)
Wenn der Eigenschaftsdatentyp DEVPROP_TYPE_STRING_LIST ist, löscht der Vorgang alle Zeichenfolgen mit der vorhandenen Zeichenfolgenliste, die der Zeichenfolge entsprechen, die vom Werteintragswert bereitgestellt wird. Die Groß-/Kleinschreibung eines Zeichens wird beim Vergleich zwischen der angegebenen Zeichenfolge und einer vorhandenen Zeichenfolge in der Zeichenfolgenliste nicht berücksichtigt.

value
Wenn der Eigenschaftsdatentyp DEVPROP_TYPE_STRING_LIST ist und der Flags-Eintrag 0x00000001 ist, liefert der Werteintragswert die Zeichenfolge, die der Löschvorgang verwendet, um in der vorhandenen Zeichenfolgenliste nach übereinstimmenden Zeichenfolgen zu suchen. Wenn eine übereinstimmende Zeichenfolge gefunden wird, entfernt der Löschvorgang die übereinstimmende Zeichenfolge aus der vorhandenen Zeichenfolgenliste.

Hinweise

Im Allgemeinen sollte eine INF-Datei nicht verwendet werden, um Geräteeigenschaften zu löschen, die möglicherweise von einer Systemkomponente oder einer anderen INF-Datei festgelegt werden. Der Hauptzweck der DelProperty-Direktive ist die Verwendung in einer INF-Datei, die eine vorherige Geräteinstallation aktualisiert, und eine Eigenschaft, die für eine vorherige Geräteinstallation festgelegt wurde, ist nicht mehr erforderlich.

Ein del-property-section-Name muss innerhalb einer INF-Datei eindeutig sein, aber auf den Abschnittsnamen kann in derselben INF-Datei von mehr als einer DelProperty-Direktiveverwiesen werden. Ein Abschnittsname muss den allgemeinen Regeln zum Definieren von Abschnittsnamen entsprechen, die unter Allgemeine Syntaxregeln für INF-Dateien beschrieben sind.

Weitere Informationen zur Verwendung der DelProperty-Direktive finden Sie unter Verwenden der INF-AddProperty-Direktive und der INF DelProperty-Direktive.

Beispiele

Das folgende Beispiel eines Abschnitts zum Löschen einer Eigenschaft enthält zwei Zeileneinträge: Der erste Zeileneintrag enthält einen Eigenschaftsnameneintragswert , der die DeviceModel-Eigenschaft löscht, und der zweite Zeileneintrag löscht die Zeichenfolge "DeleteThisString" aus einem benutzerdefinierten Geräteeigenschaftswert, dessen Datentyp DEVPROP_TYPE_STRING_LIST ist. In der zweiten Zeile lautet der Eintragswert property-category-guid "c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e", der Eigenschaftsbezeichnereintragswert "2", und der Flags-Eintragswert ist "0x00000001,"

[SampleDelPropertySection]
DeviceModel
{c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e}, 2, 0x00000001, "DeleteThisString"

Weitere Informationen

Addproperty