ABSCHNITT "INF-DDInstall.COM"

Jeder Abschnitt pro Modelle DDInstall.COM enthält eine oder mehrere INF-AddComServer-Direktiven , die auf andere INF-Writer-definierte Abschnitte in einer INF-Datei verweisen. Dieser Abschnitt wird für 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-Direktive erforderlich.

Entries

AddComServer=com-server-name,flags,com-server-install-section

Die AddComServer-Direktive verweist auf einen INF-writer-defined com-server-install-section an anderer Stelle in der INF-Datei. Die AddComServer-Direktive kann ein oder mehrere Male verwendet werden, um mehrere COM-Server zu registrieren. Weitere Informationen finden Sie unter INF AddComServer-Direktive 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 Abschnitte enthalten, die zum Installieren dieses Geräts erforderlich sind. Wenn dieser Eintrag angegeben ist, ist auch ein Bedarfseintrag 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 Abschnitt verwiesen wird.

Remarks

COM-Binärdateien werden mithilfe der CopyFiles-Direktive 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äterelativen Registrierungsspeicherorten.

Clients müssen CoRegisterDeviceCatalog für einen Arbeitsthread aufrufen, bevor CoCreateInstance aufgerufen wird. Durch Aufrufen von CoRegisterDeviceCatalog werden die COM-Serverregistrierungen im Prozess für die zu verwendende COM-Laufzeit verfügbar.

DDInstall.COM Abschnitt sollte die gleichen Plattform- und Betriebssystem-Dekorationen wie die zugehörigen DDInstall-Abschnitte aufweisen. Beispielsweise würde ein Abschnitt "install-section-name.ntamd64" einen entsprechenden install-section-name.ntamd64.COM Abschnitt aufweisen. Auf den angegebenen DDInstall-Abschnitt muss in einem geräte-/modellspezifischen Eintrag im Abschnitt "Modelle pro Hersteller" der INF-Datei verwiesen werden. Die in der formalen Syntax-Anweisung gezeigten Installationsabschnittsnamen können in einen solchen DDInstall.COM Abschnittsnamen in plattformübergreifende INF-Dateien eingefügt werden.

Weitere Informationen zur Verwendung der systemdefinierten . nt-, .ntamd64- und .ntarm64-Erweiterungen finden Sie unter Creating INF Files for Multiple Platforms and Operating Systems.

Examples

[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"

Siehe auch

  • Zuletzt aktualisiert um