Direttiva INF AddComponent
Una direttiva AddComponent viene usata all'interno di un inF DDInstall. Sezione Components di un file INF di estensione. Crea un dispositivo figlio virtuale per il componente software nel dispositivo corrente. Questa direttiva è supportata per Windows 10 versione 1703 e successive.
[DDInstall.Components]
AddComponent=ComponentName,[flags],component-install-section
Voci
ComponentName
Specifica il nome del componente software da creare. Ogni direttiva AddComponent in un file INF deve avere un valore univoco.
flags
Specifica uno o più flag (ORed), attualmente non definiti ma riservati per un uso futuro.
component-install-section
Fa riferimento a una sezione definita dal writer INF che contiene informazioni per la creazione del componente software denominato per questo dispositivo.
Commenti
Ogni nome di sezione creato da INF-writer deve essere univoco all'interno del file INF e deve seguire le regole generali per la definizione dei nomi di sezione. Per altre informazioni su queste regole, vedere Regole di sintassi generali per i file INF.
Una direttiva AddComponent deve fare riferimento a una sezione component-install-section denominata altrove nel file INF. Ogni sezione di questo tipo ha il formato seguente:
[component-install-section]
ComponentIDs=component-id[,component-id] …
[Description=description]
Ogni componente-install-section deve avere almeno la voce ComponentIDs , come illustrato di seguito. Tuttavia, le voci rimanenti sono facoltative.
Si noti che i ComponentID sono HardwareID, ovvero sono stringhe definite dallo sviluppatore hardware. Per garantire l'univocità di questi ID, nella maggior parte dei casi, è consigliabile seguire lo schema dell'identificatore usato per i dispositivi PCI. È possibile che un fornitore voglia usare uno schema diverso, ma che dipende dallo scenario.
Ad esempio, un fornitore con più componenti in un singolo dispositivo potrebbe voler associare gli ID hardware del componente all'elemento padre. In questo caso, è possibile creare un ComponentID aggiungendo un identificatore di componente a quattro caratteri definito dal fornitore all'ID hardware dell'elemento padre.
voci e valori della sezione Component-Install
ComponentID=id1[, id2] ... [, idN]
Specifica gli identificatori del componente per un componente software. Gli ID componente funzionano allo stesso modo degli ID hardware e devono seguire una formattazione simile. Per un componente software, il sistema antepone i valori forniti da INF con SWC\ per creare gli ID hardware. Ad esempio, un valore ComponentIDs dei VID0001&PID0001 risultati in un ID hardware di SWC\VID0001&PID0001.
Descrizione=Descrizione
Specifica facoltativamente una stringa che descrive il componente software, in genere per la localizzazione, espressa come token %strkey% definito in una sezione Stringhe INF.
Se una stringa di descrizione contiene token %strkey%, ogni token può rappresentare un massimo di 511 caratteri. La stringa totale, dopo eventuali sostituzioni di token di stringa, non deve superare i 1024 caratteri.