Dyrektywa INF DelProperty

Dyrektywa DelProperty odwołuje się do co najmniej jednej sekcji pliku INF, która usuwa właściwości urządzenia dla wystąpienia urządzenia, klasy konfiguracji urządzenia, klasy interfejsu urządzenia lub interfejsu urządzenia.

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

Dyrektywę DelProperty można określić w dowolnych sekcjach przedstawionych w powyższej instrukcji składni formalnej.

Sekcja del-property-, do którego odwołuje się dyrektywa DelProperty, ma następujący 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]])
...

Sekcja del-property-może zawierać dowolną liczbę wpisów nazwy właściwości lub wpisów identyfikatora GUID właściwości, z których każda znajduje się w osobnym wierszu.

Wpisy

nazwa-właściwości
Jedna z nazw właściwości reprezentujących właściwości pakietu sterownika wystąpienia urządzenia. Obsługiwane nazwy właściwości są takie same jak te, które zostały opisane dla wpisu nazwy właściwościdyrektywy INF AddProperty.

property-category-guid
Wartość identyfikatora GUID identyfikującą kategorię właściwości. Wartość identyfikatora GUID może być identyfikatorem GUID zdefiniowanym przez system, który identyfikuje kategorię właściwości zdefiniowanych przez system lub niestandardowy identyfikator GUID identyfikujący kategorię właściwości niestandardowych. Obsługiwane wartości identyfikatora GUID są takie same jak te, które zostały opisane dla wpisu property-category-guid dyrektywy INF AddProperty .

właściwość pid
Identyfikator właściwości wskazujący konkretną właściwość w kategorii właściwości, która jest wskazywana przez wartość property-category-guid . Ze względów systemu wewnętrznego identyfikator właściwości musi być większy lub równy dwóm.

flags
Opcjonalna wartość flagi szesnastkowej, która kontroluje operację usuwania. Jedyną obsługiwaną wartością flagi jest następująca:

0x00000001 (FLG_DELPROPERTY_MULTI_SZ_DELSTRING)
Jeśli typ danych właściwości jest DEVPROP_TYPE_STRING_LIST, operacja usuwa wszystkie ciągi z istniejącą listą ciągów zgodną z ciągiem dostarczonym przez wartość wpisu wartości. Wielkość liter znaku nie jest uwzględniana w porównaniu między podanym ciągiem a istniejącym ciągiem na liście ciągów.

value
Jeśli typ danych właściwości jest DEVPROP_TYPE_STRING_LIST, a wpis flagi jest 0x00000001, wartość wpisu wartości dostarcza ciąg używany przez operację usuwania do wyszukiwania pasujących ciągów na istniejącej liście ciągów, a jeśli zostanie znaleziony pasujący ciąg, operacja usuwania usuwa pasujący ciąg z istniejącej listy ciągów.

Remarks

Ogólnie rzecz biorąc, plik INF nie powinien być używany do usuwania właściwości urządzenia, które mogą być ustawiane przez składnik systemu lub inny plik INF. Podstawowym celem dyrektywy DelProperty jest użycie w pliku INF, który aktualizuje poprzednią instalację urządzenia i właściwość ustawioną dla poprzedniej instalacji urządzenia nie jest już wymagana.

Nazwa sekcji del-property-section musi być unikatowa w pliku INF, ale nazwa sekcji może odwoływać się do więcej niż jednej dyrektywy DelPropertyw tym samym pliku INF. Nazwa sekcji musi być zgodna z ogólnymi regułami definiowania nazw sekcji opisanych w ogólnych regułach składni dla plików INF.

Aby uzyskać więcej informacji na temat używania dyrektywy DelProperty, zobacz Using the INF AddProperty Directive and the INF DelProperty Directive (Używanie dyrektywy INF AddProperty) i INF DelProperty Directive (Dyrektywa INF DelProperty).

Examples

Poniższy przykład sekcji właściwości delete zawiera dwa wpisy wiersza: pierwszy wpis wiersza zawiera wartość wpisu nazwa-właściwości , która usuwa właściwość DeviceModel , a drugi wpis wiersza usuwa ciąg "DeleteThisString" z niestandardowej wartości właściwości urządzenia, której typ danych jest DEVPROP_TYPE_STRING_LIST. W drugim wierszu wartość wpisu property-category-guid to "c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e", wartość wpisu identyfikatora właściwości to "2", a wartość wpisu flagi to "0x00000001",

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

Informacje dodatkowe

AddProperty