Direttiva INF DelProperty

Attenzione

Se si sta creando un pacchetto universale o Windows Driver, questa direttiva non è valida. Vedere Uso di un file INF universale e Introduzione con i driver di Windows.

Una direttiva DelProperty fa riferimento a una o più sezioni file INF che eliminano le proprietà del dispositivo per un'istanza del dispositivo, una classe di installazione del dispositivo, una classe di interfaccia del dispositivo o un'interfaccia del dispositivo.

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

Una direttiva DelProperty può essere specificata in una delle sezioni visualizzate nell'istruzione di sintassi formale precedente.

Una sezione del-property a cui fa riferimento una direttiva DelProperty ha il formato seguente:

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

Una sezione del-property può avere un numero qualsiasi di voci nome proprietà o voci con guid di proprietà, ognuna in una riga separata.

Voci

nome della proprietà
Uno dei nomi delle proprietà che rappresentano le proprietà del pacchetto del driver dell'istanza del dispositivo. I nomi delle proprietà supportati sono uguali a quelli descritti per la voce nome proprietà della direttiva INF AddProperty.

property-category-guid
Valore GUID che identifica la categoria di proprietà. Il valore GUID può essere un GUID definito dal sistema che identifica una categoria di proprietà definita dal sistema o un GUID personalizzato che identifica una categoria di proprietà personalizzata. I valori GUID supportati sono uguali a quelli descritti per la voce property-category-guid della direttiva INF AddProperty .

property-pid
Identificatore di proprietà che indica la proprietà specifica all'interno della categoria di proprietà indicata dal valore property-category-guid . Per motivi di sistema interni, un identificatore di proprietà deve essere maggiore o uguale a due.

flags
Valore del flag esadecimale facoltativo che controlla l'operazione di eliminazione. L'unico valore di flag supportato è il seguente:

0x00000001 (FLG_DELPROPERTY_MULTI_SZ_DELSTRING )
Se il tipo di dati della proprietà è DEVPROP_TYPE_STRING_LIST, l'operazione elimina tutte le stringhe con l'elenco stringa esistente che corrisponde alla stringa fornita dal valore di voce del valore. Il caso di un carattere non viene considerato nel confronto tra la stringa specificata e una stringa esistente nell'elenco di stringhe.

value
Se il tipo di dati della proprietà è DEVPROP_TYPE_STRING_LIST e la voce flag è 0x00000001, il valore della voce valore fornisce la stringa utilizzata dall'operazione di eliminazione per cercare stringhe corrispondenti nell'elenco di stringhe esistenti e, se viene trovata una stringa corrispondente, l'operazione di eliminazione rimuove la stringa corrispondente dall'elenco di stringhe esistenti.

Commenti

In generale, un file INF non deve essere usato per eliminare le proprietà del dispositivo che potrebbero essere impostate da un componente di sistema o da un altro file INF. Lo scopo principale della direttiva DelProperty è l'uso in un file INF che aggiorna un'installazione precedente del dispositivo e una proprietà impostata per un'installazione precedente del dispositivo non è più necessaria.

Un nome della sezione del property deve essere univoco all'interno di un file INF, ma il nome della sezione può essere fatto riferimento a più di una direttiva DelPropertynello stesso file INF. Un nome di sezione deve seguire le regole generali per definire i nomi di sezione descritti in Regole di sintassi generali per i file INF.

Per altre informazioni sull'uso della direttiva DelProperty, vedere Uso della direttiva INF AddProperty e della direttiva INF DelProperty.

Esempio

L'esempio seguente di una sezione di proprietà delete include due voci di riga: la prima voce include un valore di voce nome proprietà che elimina la proprietà DeviceModel e la seconda voce di riga elimina la stringa "DeleteThisString" da un valore di proprietà del dispositivo personalizzato il cui tipo di dati è DEVPROP_TYPE_STRING_LIST. Nella seconda riga il valore della voceproperty-category-guid è "c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e", il valore di voce dell'identificatore della proprietà è "2", mentre il valore di voce flags è "0x00000001",

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

Vedi anche

AddProperty