Sekcja INF DDInstall.CoInstallers

Caution

Począwszy od Windows 11 wersji 22H2, pakiet sterowników korzystający z tej sekcji nie kwalifikuje się już do podpisu z Centrum deweloperów sprzętu.

Pakiety sterowników uniwersalnych i sterowniki Windows nie mogą używać tej sekcji.

Ta opcjonalna sekcja rejestruje co najmniej jednego współinstalatora specyficznego dla urządzenia na nośniku dystrybucji, aby uzupełnić operacje istniejących instalatorów klas urządzeń.

[install-section-name.CoInstallers] |
[install-section-name.nt.CoInstallers] | 
[install-section-name.ntx86.CoInstallers] | 
[install-section-name.ntia64.CoInstallers] | (Windows XP and later versions of Windows)
[install-section-name.ntamd64.CoInstallers] | (Windows XP and later versions of Windows)
[install-section-name.ntarm.CoInstallers] | (Windows 8 and later versions of Windows)
[install-section-name.ntarm64.CoInstallers] (Windows 10 version 1709 and later versions of Windows)
  
AddReg=add-registry-section[,add-registry-section]... 
CopyFiles=@filename | file-list-section[,file-list-section]...
[Include=filename.inf[,filename2.inf]...]
[Needs=inf-section-name[,inf-section-name]...]
[DelFiles=file-list-section[,file-list-section]...]
[RenFiles=file-list-section[,file-list-section]...]
[DelReg=del-registry-section[,del-registry-section]...] 
[BitReg=bit-registry-section[,bit-registry-section]...]
[UpdateInis=update-ini-section[,update-ini-section]...]
[UpdateIniFields=update-inifields-section[,update-inifields-section]...]
[Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...]
... 

Wpisy

AddReg=add-registry-section[,add-registry-section]...
Odwołuje się do co najmniej jednej sekcji add-registry-definedinF, która przechowuje informacje o podanych współinstalatorach.

Klucz HKR określony w takiej sekcji add-registry wyznacza ścieżkę rejestru "klucz oprogramowania" instalowanego urządzenia. W związku z tym w przypadku współinstalatora specyficznego dla urządzenia zapisuje (lub modyfikuje) wpis wartości CoInstallers32 w kluczu "oprogramowanie" dostępnym dla każdego urządzenia/sterownika.

W przypadku współinstalatora specyficznego dla klasy program rejestruje nowe współinstalatory, modyfikując zawartość odpowiedniego pliku . CoDeviceInstallers\SetupClassGUID podklucze. Ścieżka odpowiednich podklucza SetupClassGUID rejestru musi być jawnie określona w przywoływanych sekcjach add-registry.

Aby uzyskać więcej informacji, zobacz INF AddReg Directive (Dyrektywa INF AddReg).

CopyFiles=@nazwa | pliku-list-sekcji*[,file-list-section]...
Przesyła źródłowe pliki współinstalatora do miejsca docelowego na komputerze docelowym, zwykle odwołując się do co najmniej jednego składnika zapisywania INF zdefiniowanej w pliku INF sekcji lista-plikóww innym miejscu w pliku INF. Taka sekcja listy plików określa pliki współinstalatora, które mają być kopiowane z nośnika źródłowego do katalogu docelowego w lokalizacji docelowej.

Jednak systemowe pliki INF, które instalują współinstalatory, nigdy nie używają tej dyrektywy w DDInstall. Sekcja CoInstallers(CoInstallers ).

Aby uzyskać więcej informacji, zobacz dyrektywa INF CopyFiles.

Include=nazwa pliku. inf[,nazwa_pliku2.inf]...
Określa co najmniej jeden plik INF dostarczany przez system zawierający sekcje wymagane do zainstalowania współinstalatorów dla tego urządzenia lub klasy konfiguracji urządzenia. Plik INF z tym wpisem powinien zwykle określać wymagania.

Needs=inf-section-name[,inf-section-name]...
Określa konkretne sekcje, które należy przetworzyć podczas instalacji tego urządzenia. Zazwyczaj taka nazwana sekcja to DDInstall. Sekcja CoInstallers w pliku INF dostarczonym przez system, który znajduje się w wpisie Dołączanie . Jednak może to być dowolna sekcja, do jakiej odwołuje się taka DDInstall. Sekcja CoInstallers dołączonego modułu INF.

DelFiles=file-list-section[,file-list-section]...
Odwołuje się do sekcji lista plików określającą pliki do usunięcia z obiektu docelowego. Ta dyrektywa jest rzadko używana.

Aby uzyskać więcej informacji, zobacz INF DelFiles, dyrektywa.

RenFiles=file-list-section[,file-list-section]...
Odwołuje się do sekcji lista plików określającą pliki w miejscu docelowym, które mają zostać zmienione przed skopiowaniem plików źródłowych współinstalatora do miejsca docelowego. Ta dyrektywa jest również rzadko używana.

Aby uzyskać więcej informacji, zobacz INF RenFiles, dyrektywa.

DelReg=del-registry-section[,del-registry-section]...
Odwołuje się do co najmniej jednej sekcji inf-writer-define delete-registry-section. Taka sekcja określa nieaktualne informacje o rejestrze dotyczące współinstalatorów dla poprzedniej instalacji tych samych urządzeń, które powinny zostać usunięte z rejestru. Klucz HKR określony w takiej sekcji delete-registry wyznacza ten sam podklucz rejestru, co już opisane dla wpisu AddReg. Ta dyrektywa jest rzadko używana w instalacji DDInstall. Sekcja CoInstallers(CoInstallers ).

Aby uzyskać więcej informacji, zobacz INF DelReg, dyrektywa.

BitReg=bit-registry-section[,bit-registry-section]...
Ten wpis jest prawidłowy w tej sekcji, ale prawie nigdy nie był używany. Klucz HKR określony w takiej sekcji rejestru bitów wyznacza ten sam podklucz rejestru, co już opisane dla wpisu AddReg.

Aby uzyskać więcej informacji, zobacz InF BitReg Directive (Dyrektywa INF BitReg).

UpdateInis=update-ini-section[,update-ini-section]...
Ten wpis jest prawidłowy w tej sekcji, ale prawie nigdy nie był używany.

Aby uzyskać więcej informacji, zobacz INF UpdateInis, dyrektywa.

UpdateIniFields=update-inifields-section[,update-inifields-section]...
Ten wpis jest prawidłowy w tej sekcji, ale prawie nigdy nie był używany.

Aby uzyskać więcej informacji, zobacz INF UpdateIniFields, dyrektywa.

Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...
Ten wpis jest prawidłowy w tej sekcji, ale prawie nigdy nie był używany.

Aby uzyskać więcej informacji, zobacz ini2Reg dyrektywy INF.

Remarks

Określona sekcja DDInstall musi odwoływać się do wpisu specyficznego dla urządzenia/modeli w sekcji Modele dla poszczególnych producentów pliku INF.

Jeśli inf zawiera DDInstall. Sekcja Coinstallers musi być jedna dla każdej sekcji dekorowane i nieukodowane DDInstall platformy. Jeśli na przykład inf zawiera sekcję [install-section-name.ntx86] i sekcję [install-section-name] i rejestruje współinstalacje specyficzne dla urządzenia, inf musi zawierać zarówno [install-section-name.ntx86. Sekcja Coinstallers] i [install-section-name. Sekcja Coinstallers]. Aby uzyskać więcej informacji na temat używania zdefiniowanych przez system rozszerzeń nt, ntx86, ntia64, ntamd64, ntarm i ntarm64 , zobacz Tworzenie plików INF dla wielu platform i systemów operacyjnych.

Każda dyrektywa w DDInstall. Sekcja CoInstallers może odwoływać się do więcej niż jednej nazwy sekcji zdefiniowanej przez składnik zapisywania INF. Jednak każda dodatkowa nazwana sekcja musi być oddzielona od następnej przecinkiem (,).

Każda nazwa sekcji utworzonej przez dyrektywę musi być unikatowa w pliku INF i musi być zgodna z ogólnymi regułami definiowania nazw sekcji. Aby uzyskać więcej informacji na temat tych reguł, zobacz Ogólne reguły składni dla plików INF.

Współinstalator to biblioteka DLL Win32, która zazwyczaj zapisuje dodatkowe informacje o konfiguracji w rejestrze lub wykonuje inne zadania instalacyjne, które wymagają dynamicznie generowanych informacji specyficznych dla systemu, które nie są dostępne podczas tworzenia inf. Współinstalator specyficzny dla urządzenia uzupełnia operacje instalacji albo instalatora urządzenia systemu operacyjnego lub odpowiedniego instalatora klasy, gdy to urządzenie jest zainstalowane.

Aby uzyskać więcej informacji na temat pisania i używania współinstalatorów, zobacz Pisanie współinstalatora.

Instalowanie obrazów współinstalatora

Wszystkie pliki współinstalatora muszą zostać skopiowane do katalogu %SystemRoot%\system32 . Podobnie jak każda operacja INF CopyFiles , miejsce docelowe jest kontrolowane jawnie dla nazwanej sekcji file-list-section w sekcji DestinationDirs pliku INF przez wartość przesłonięcia11 lub przez podanie tej wartości różnicy dla wpisu DefaultDestDir .

Rejestrowanie Device-Specific współinstalatorów

Zarejestrowanie co najmniej jednego współinstalatora specyficznego dla urządzenia wymaga dodania wpisu wartości typu REG_MULTI_SZ do rejestru. Określ sekcję add-registry-referenced by the AddReg , używając następującego formularza ogólnego:

[DDInstall.CoInstallers_DeviceAddReg]
 
HKR,,CoInstallers32,0x00010000,"DevSpecificCoInstall.dll
   [,DevSpecificEntryPoint]"[,"DevSpecific2CoInstall.dll
      [,DevSpecific2EntryPoint]"...] 

Wpis HKR jest wymieniony jako pojedynczy wiersz w pliku INF, a każda podana biblioteka DLL współinstalatora specyficznego dla urządzenia musi mieć unikatową nazwę. Po zarejestrowaniu wymienionych współinstalatorów instalator urządzenia systemu wywołuje je w każdym kolejnym kroku procesu instalacji tego urządzenia.

Jeśli opcjonalny element DevSpecificEntryPoint zostanie pominięty, domyślna nazwa procedury CoDeviceInstall jest używana jako punkt wejścia biblioteki DLL współinstalatora.

Aby uzyskać więcej informacji, zobacz Rejestrowanie Device-Specific współinstalatora.

Rejestrowanie Device-Class współinstalatorów

Aby dodać wpis wartości (i podklucz klasy konfiguracji, jeśli jeszcze nie istnieje) dla co najmniej jednego współinstalatora klasy urządzeń do rejestru, sekcja add-registry , do której odwołuje się dyrektywa AddReg , ma następującą ogólną formę:

[DDInstall.CoInstallers_ClassAddReg]
 
HKLM,System\CurrentControlSet\Control
    \CoDeviceInstallers,{SetupClassGUID},
       0x00010008,"DevClssCoInst.dll[,DevClssEntryPoint]" 
 ...

Każdy wpis w takiej sekcji add-registry jest wymieniony jako pojedynczy wiersz w pliku INF, a każda podana biblioteka DLL współinstalatora klas musi mieć unikatową nazwę. Jeśli podane współinstalatory powinny być używane dla więcej niż jednej klasy konfiguracji urządzenia, ta sekcja add-registry może zawierać więcej niż jeden wpis, z których każda ma odpowiednią wartość SetupClassGUID .

Taki dodatkowy współinstalator klasy urządzenia nie może zastąpić żadnych zarejestrowanych współinstalatorów dla istniejącego instalatora klas. W związku z tym współinstalator klasy musi mieć unikatową nazwę, a podana wartość typu REG_MULTI_SZ musi zostać dołączona (wskazana przez wartość 8 w wartości flagi0x0010008) do wpisów współinstalatora specyficznego dla klasy, jeśli istnieje, już obecnych w podkluczu {SetupClassGUID}.

Uwaga

Funkcje SetupAPI nigdy nie dołączają zduplikowanego elementu DevClssCoInstall.dll do wpisu wartości, jeśli współinstalator o tej samej nazwie jest już zarejestrowany.

InF dla dodatkowego współinstalatora klasy urządzenia można aktywować przez zainstalowanie prawym przyciskiem myszy lub za pomocą wywołania instalacji SetupInstallFromInfSection wykonanej przez aplikację instalacji urządzenia.

Examples

W tym przykładzie pokazano DDInstall. Sekcja CoInstallers dla szeregowych kart sieciowych IrDA. Dostarczone przez system karty sieciowe INF dla tych kart sieciowych IrDA (szeregowych) dostarcza współinstalator do instalatora klasy IrDA systemu.

; DDInstall section
[PNP.NT]
AddReg=ISIR.reg, Generic.reg, Serial.reg
PromptForPort=0     ; This is handled by IRCLASS.DLL
LowerFilters=SERIAL ; This is handled by IRCLASS.DLL
BusType=14
Characteristics=0x4 ; NCF_PHYSICAL 

; ... PNP.NT.Services section omitted here
[PNP.NT.CoInstallers]
AddReg = ISIR.CoInstallers.reg 
; ...

[IRSIR.reg]
HKR, Ndi, HelpText, 0, %IRSIR.Help%
HKR, Ndi, Service, 0, "IRSIR"
HKR, Ndi\Interfaces, DefUpper, 0, "ndisirda"
HKR, Ndi\Interfaces, DefLower, 0, "nolower"
HKR, Ndi\Interfaces, UpperRange, 0, "ndisirda"
HKR, Ndi\Interfaces, LowerRange, 0, "nolower"

[Generic.reg]
HKR,,InfraredTransceiverType,0,"0"

[Serial.reg]
HKR,,SerialBased,0, "0"

[ISIR.CoInstallers.reg]
HKR,,CoInstallers32,0x00010000,"IRCLASS.dll,IrSIRClassCoInstaller"

; ... Services and Event Log registry sections omitted here
[Strings]
; ...
IRSIR.Help = "An IrDA serial infrared device is a built-in COM port or 
external transceiver which transmits infrared pulses. This NDIS 
miniport driver installs as a network adapter and binds to the FastIR 
protocol."

Poprzedni PNP. NT. Sekcja CoInstallers odwołuje się tylko do sekcji add-registry specyficznej dla współinstalatora.

Nie ma dyrektywy CopyFiles , ponieważ ta dostarczana przez system funkcja INF instaluje zestaw urządzeń sieciowych IrDA. Podobnie jak wszystkie systemowe pliki INF, ten plik INF używa wpisu LayoutFile w sekcji Wersja w celu przeniesienia pliku współinstalatora do miejsca docelowego.

Wszelkie DDInstall. Sekcja CoInstallers w inf dostarczonym przez IHV lub OEM wymaga dyrektywy CopyFiles , a także sekcji SourceDisksNames i SourceDisksFiles .

Informacje dodatkowe

DodajReg

BitReg

CopyFiles

DDInstall

DelFiles

DelReg

DestinationDirs

Ini2Reg

RenFiles

SourceDisksFiles

SourceDisksNames

UpdateIniFields

Wersja