INF DDInstall.COM-Abschnitt
Jeder INF DDInstall.COM-Abschnitt enthält pro Modell eine oder mehrere INF-AddComServer-Anweisungen, die auf andere INF-Writer-definierte Abschnitte in einer INF-Datei verweisen. Dieser Abschnitt wird ab Windows 11, Version 24H2 und höher unterstützt.
[install-section-name.COM] |
[install-section-name.nt.COM] |
[install-section-name.ntamd64.COM] |
[install-section-name.ntarm64.COM]
AddComServer = com-server-name, [flags], com-server-install-section
[Include=filename.inf[,filename2.inf]...]
[Needs=inf-section-name[,inf-section-name]...]
Zum Registrieren von COM-Servern ist mindestens eine AddComServer-Anweisung erforderlich.
Entries
AddComServer=com-server-name,flags,com-server-install-section
Die AddComServer-Anweisung verweist auf einen INF-writer-defined com-server-install-section an anderer Stelle in der INF-Datei. Die AddComServer-Anweisung kann ein oder mehrere Male verwendet werden, um mehrere COM-Server zu registrieren. Weitere Informationen finden Sie in der INF AddComServer-Anweisung und für COM-Server im Allgemeinen unter COM-Clients und -Server.
Include=filename.inf[,filename2.inf]...
Dieser optionale Eintrag gibt eine oder mehrere andere vom System bereitgestellte INF-Dateien an, die die zum Installieren dieses Geräts erforderlichen Abschnitte enthalten. Wenn dieser Eintrag angegeben ist, ist auch ein Needs-Eintrag erforderlich.
Needs=inf-section-name[,inf-section-name]...
Dieser optionale Eintrag gibt den Abschnitt an, der während der Installation dieses Geräts verarbeitet werden muss. In der Regel ist der Abschnitt ein DDInstall.COM-Abschnitt in einer vom System bereitgestellten INF-Datei, die in einem Include-Eintrag aufgeführt ist. Es kann jedoch ein beliebiger Abschnitt sein, auf den in einem DDInstall.COM verwiesen wird.
Hinweise
COM-Binärdateien werden mithilfe der CopyFiles-Anweisung im Abschnitt 'DDInstall' installiert. Binärdateien sollten an einem Speicherort relativ zum Treiberspeicherpfad des Treiberpakets installiert werden (z. B. DIRID 13). Ebenso schreibt die Geräteinstallation COM-Registrierungen unter gerätebezogene Registrierungspositionen.
Clients müssen CoRegisterDeviceCatalog für einen Worker-Thread aufrufen, bevor CoCreateInstance aufgerufen wird. Durch Aufrufen von CoRegisterDeviceCatalog werden die COM-Serverregistrierungen im Prozess für die zu verwendende COM-Laufzeit verfügbar.
Der DDInstall.COM Abschnitt sollte die gleichen Plattform- und Betriebssystemdekorationen haben wie die zugehörigen DDInstall Abschnitte. Beispielsweise hätte ein install-section-name.ntamd64-Abschnitt einen entsprechenden install-section-name.ntamd64.COM-Abschnitt. Auf den angegebenen DDInstall-Abschnitt muss in einem geräte-/modellspezifischen Eintrag im Abschnitt Models der INF-Datei pro Hersteller verwiesen werden. Die in der formalen Syntax-Anweisung gezeigten, Groß- und Kleinschreibung nicht berücksichtigende install-section-name-Erweiterungen können in einen solchen DDInstall.COM-Abschnittsnamen in plattformübergreifenden INF-Dateien eingefügt werden.
Weitere Informationen zur Verwendung der systemdefinierten Erweiterungen .nt, .ntamd64 und .ntarm64 finden Sie unter Erstellen von INF-Dateien für mehrere Plattformen und Betriebssysteme.
Beispiele
[Device_Install.COM]
AddComServer = VendorComServer,, VendorComServer_Inst
[VendorComServer_Inst]
ServerType = 1 ; in-proc
ServerBinary = %13%\Vendor_ComServer.dll
AddComClass = {bb2b85ab-9473-42e5-8d1a-0f01d3879879},, Vendor_ComClass_Inst
[Vendor_ComClass_Inst]
Description = %Vendor_ComClass_Desc%
ThreadingModel = Neutral
[Strings]
%Vendor_ComClass_Desc%="Vendor Com Server"