Freigeben über


INF-AddComponent-Direktive

Eine AddComponent- Direktive wird in einer INF-DDInstall-verwendet. Komponenten Abschnitt einer Erweiterung INF-Datei. Es erstellt ein virtuelles untergeordnetes Gerät für die Softwarekomponente unter dem aktuellen Gerät. Diese Direktive wird für Windows 10, Version 1703 und höher, unterstützt.

[DDInstall.Components]

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

Einträge

ComponentName

Gibt den Namen der zu erstellenden Softwarekomponente an. Jede AddComponent Direktive in einer INF-Datei muss einen eindeutigen Wert aufweisen.

Kennzeichnungen

Gibt ein oder mehrere Flags (ORed) an, die derzeit nicht definiert, aber für die zukünftige Verwendung reserviert sind.

Komponenteninstallationsabschnitt

Verweist auf einen INF-Writer-definierten Abschnitt, der Informationen zum Erstellen der benannten Softwarekomponente für dieses Gerät enthält.

Bemerkungen

Jeder von INF-Autor*innen erstellte Abschnittsname muss innerhalb der INF-Datei eindeutig sein und den allgemeinen Regeln für die Definition von Abschnittsnamen entsprechen. Weitere Informationen zu diesen Regeln finden Sie unter Allgemeine Syntaxregeln für INF-Dateien.

Eine AddComponent--Direktive muss auf einen benannten Komponenteninstallationsabschnitt verweisen, an anderer Stelle in der INF-Datei. Jeder dieser Abschnitte weist das folgende Formular auf:

[component-install-section]

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

Jeder Komponenteninstallationsabschnitt muss mindestens den eintrag ComponentIDs aufweisen, wie hier gezeigt. Die verbleibenden Einträge sind jedoch optional.

Beachten Sie, dass ComponentIDs-HardwareIDssind, was bedeutet, dass sie Zeichenfolgen sind, die vom Hardwareentwickler definiert werden. Um die Eindeutigkeit dieser IDs zu gewährleisten, empfehlen wir in den meisten Fällen, das Bezeichnerschema zu folgen, das für PCI-Geräteverwendet wird. Es ist möglich, dass ein Anbieter möglicherweise ein anderes Schema verwenden möchte, aber das hängt vom Szenario ab.

Beispielsweise kann ein Anbieter mit mehreren Komponenten auf einem einzelnen Gerät die Hardware-IDs der Komponente dem übergeordneten Element zuordnen. In diesem Fall könnten sie eine ComponentID- erstellen, indem sie eine vom Anbieter definierte Komponenten-ID mit vier Zeichen an die Hardware-ID des übergeordneten Elements anfügen.

Component-Install Abschnittseinträge und -werte

ComponentIDs=id1[, id2] ... [, idN]

Gibt die Komponentenbezeichner für eine Softwarekomponente an. Komponenten-IDs funktionieren auf die gleiche Weise wie Hardware-IDs und sollten ähnlichen Formatierungfolgen. Bei einer Softwarekomponente stellt das System die inF bereitgestellten Werte mit SWC\ vor, um die Hardware-IDs zu erstellen. Beispielsweise führt ein ComponentIDs Wert von VID0001&PID0001 zu einer Hardware-ID von SWC\VID0001&PID0001.

Beschreibung=Beschreibung

Gibt optional eine Zeichenfolge an, die die Softwarekomponente beschreibt, in der Regel für die Lokalisierung, ausgedrückt als %strkey% Token, das in einem INF-Zeichenfolgenabschnittdefiniert ist.

Wenn eine Beschreibungszeichenfolge %strkey% Token enthält, kann jedes Token maximal 511 Zeichen darstellen. Die Gesamtzeichenfolge sollte nach jeder Ersetzung von Zeichenfolgentoken 1024 Zeichen nicht überschreiten.

Siehe auch

Verwenden einer INF-Komponente.

DDInstall.Komponenten

INF-AddSoftware-Direktive