Direttiva INF DelProperty
Attenzione
Se stai creando un pacchetto universale o windows Driver, questa direttiva non è valida. Vedi Uso di un file INF universale e Introduzione allo sviluppo di driver windows.
Una direttiva DelProperty fa riferimento a una o più sezioni di 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)
È possibile specificare una direttiva DelProperty in una delle sezioni illustrate 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.
whse.
property-name
Uno dei nomi delle proprietà che rappresentano le proprietà del pacchetto 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 facoltativo del flag esadecimale che controlla l'operazione di eliminazione. L'unico valore del 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 di stringhe esistente che corrisponde alla stringa fornita dal valore della voce di valore. Il caso di un carattere non viene considerato nel confronto tra la stringa fornita e una stringa esistente nell'elenco di stringhe.
value
Se il tipo di dati della proprietà è DEVPROP_TYPE_STRING_LIST e la voce flags è 0x00000001, il valore della voce di valore fornisce la stringa utilizzata dall'operazione di eliminazione per cercare stringhe corrispondenti nell'elenco di stringhe esistente e, se viene trovata una stringa corrispondente, l'operazione di eliminazione rimuove la stringa corrispondente dall'elenco di stringhe esistente.
Osservazioni:
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 da 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.
Esempi
L'esempio seguente di una sezione della 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 riga elimina la stringa "DeleteThisString" da un valore della proprietà del dispositivo personalizzato il cui tipo di dati è DEVPROP_TYPE_STRING_LIST. Nella seconda riga il valore della voce property-category-guid è "c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e", il valore di voce dell'identificatore di proprietà è "2" e il valore di voce flags è "0x00000001",
[SampleDelPropertySection]
DeviceModel
{c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e}, 2, 0x00000001, "DeleteThisString"