INF AddComponent-Direktive
Eine AddComponent-Direktive wird in einem INF DDInstall verwendet. Komponentenabschnitt einer ERWEITERUNGS-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 über einen eindeutigen Wert verfügen.
flags
Gibt ein oder mehrere Flags (ORed) an, die derzeit nicht definiert, aber für die zukünftige Verwendung reserviert sind.
component-install-section
Verweist auf einen vom INF-Writer definierten Abschnitt, der Informationen zum Erstellen der benannten Softwarekomponente für dieses Gerät enthält.
Bemerkungen
Jeder vom INF-Writer erstellte Abschnittsname muss innerhalb der INF-Datei eindeutig sein und den allgemeinen Regeln zum Definieren von Abschnittsnamen entsprechen. Weitere Informationen zu diesen Regeln finden Sie unter Allgemeine Syntaxregeln für INF-Dateien.
Eine AddComponent-Direktive muss an anderer Stelle in der INF-Datei auf einen benannten component-install-section verweisen. Jeder dieser Abschnitte hat die folgende Form:
[component-install-section]
ComponentIDs=component-id[,component-id] …
[Description=description]
Jeder Komponenteninstallationsabschnitt muss mindestens den Eintrag ComponentIDs enthalten, wie hier gezeigt. Die übrigen Einträge sind jedoch optional.
Beachten Sie, dass ComponentIDsHardwareIDs sind, was bedeutet, dass es sich um Zeichenfolgen handelt, die vom Hardwareentwickler definiert werden. Um die Eindeutigkeit dieser IDs sicherzustellen, wird in den meisten Fällen empfohlen, das für PCI-Geräte verwendete Bezeichnerschema zu befolgen. Es ist möglich, dass ein Anbieter ein anderes Schema verwenden möchte, aber dies hängt vom Szenario ab.
Beispielsweise möchte ein Anbieter mit mehreren Komponenten auf einem einzelnen Gerät die Hardware-IDs der Komponente dem übergeordneten Gerät zuordnen. In diesem Fall können sie eine ComponentID erstellen, indem sie einen vierstelligen, vom Anbieter definierten Komponentenbezeichner an die Hardware-ID des übergeordneten Elements anfügen.
Component-Install Abschnittseinträge und -werte
Komponenten-IDs=id1[, id2] ... [, idN]
Gibt die Komponentenbezeichner für eine Softwarekomponente an. Komponenten-IDs funktionieren genauso wie Hardware-IDs und sollten einer ähnlichen Formatierung folgen. Für eine Softwarekomponente stellt das System die von INF bereitgestellten Werte SWC\ voran, 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 ABSCHNITT "INF-Zeichenfolgen" definiert ist.
Wenn eine Beschreibungszeichenfolge %strkey%-Token enthält, kann jedes Token maximal 511 Zeichen darstellen. Die Gesamtzeichenfolge darf nach ersetzungen von Zeichenfolgentoken 1.024 Zeichen nicht überschreiten.
Weitere Informationen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für