Partager via


INF AddComponent Directive

Une directive AddComponent est utilisée dans un DDInstall INF. Section Composants d’un fichier INF d’extension. Il crée un appareil enfant virtuel pour le composant logiciel sous l’appareil actuel. Cette directive est prise en charge pour Windows 10 version 1703 et ultérieure.

[DDInstall.Components]

AddComponent=ComponentName,[flags],component-install-section

Entrées

ComponentName

Spécifie le nom du composant logiciel à créer. Chaque directive AddComponent d’un fichier INF doit avoir une valeur unique.

flags

Spécifie un ou plusieurs indicateurs (ORed), actuellement non définis mais réservés à une utilisation future.

component-install-section

Fait référence à une section définie par INF-writer qui contient des informations pour créer le composant logiciel nommé pour cet appareil.

Notes

Chaque nom de section créé par l’enregistreur INF doit être unique dans le fichier INF et doit suivre les règles générales de définition des noms de section. Pour plus d’informations sur ces règles, consultez Règles de syntaxe générales pour les fichiers INF.

Une directive AddComponent doit référencer une section d’installation de composant nommée ailleurs dans le fichier INF. Chacune de ces sections a la forme suivante :

[component-install-section]

ComponentIDs=component-id[,component-id] …
[Description=description]

Chaque section d’installation de composant doit avoir au moins l’entrée ComponentIDs , comme illustré ici. Toutefois, les entrées restantes sont facultatives.

Notez que les ID de composant sont desID matériels, ce qui signifie qu’il s’agit de chaînes définies par le développeur de matériel. Pour garantir l’unicité de ces ID, dans la plupart des cas, nous vous recommandons de suivre le schéma d’identificateur utilisé pour les appareils PCI. Il est possible qu’un fournisseur souhaite utiliser un autre schéma, mais cela dépend du scénario.

Par exemple, un fournisseur avec plusieurs composants sur un seul appareil peut vouloir associer les ID matériels du composant au parent. Dans ce cas, ils peuvent créer un ComponentID en ajoutant un identificateur de composant défini par le fournisseur à quatre caractères à l’ID matériel du parent.

Component-Install entrées et valeurs de section

Id de= composant id1[, id2] ... [, idN]

Spécifie les identificateurs de composant pour un composant logiciel. Les ID de composant fonctionnent de la même façon que les ID matériels et doivent suivre une mise en forme similaire. Pour un composant logiciel, le système ajoute les valeurs SWC\ fournies par INF pour créer les ID matériels. Par exemple, une valeur ComponentIDs de VID0001&PID0001 entraîne un ID matériel de SWC\VID0001&PID0001.

Description=Description

Spécifie éventuellement une chaîne qui décrit le composant logiciel, généralement pour la localisation, exprimée sous la forme d’un jeton %strkey% défini dans une section Inf Strings.

Si une chaîne de description contient des jetons %strkey%, chaque jeton peut représenter un maximum de 511 caractères. La chaîne totale, après toute substitution de jeton de chaîne, ne doit pas dépasser 1 024 caractères.

Voir aussi

Utilisation d’un fichier INF de composant.

DDInstall. Composants

INF Add Directive relative aux logiciels