Secção INF DefaultInstall

Note

Se estiver a construir um pacote de driver universal, esta secção só é válida se tiver uma decoração arquitetónica, por exemplo [DefaultInstall.NTAMD64].

Note

Usar ambas as secções DefaultInstall e Fabricante no seu INF causará falhas na validação universal do INF e pode levar a comportamentos de instalação inconsistentes. Veja usar um ficheiro INF universal.

A secção DefaultInstall de um ficheiro INF é acedida se o utilizador selecionar o elemento do menu "Instalar" após selecionar e manter pressionado (ou clicar com o botão direito) no nome do ficheiro INF. No Windows 10 versão 1903 e versões posteriores do Windows, um INF com DefaultInstall pode ser usado em muitas APIs de pacotes de drivers se cumprir os requisitos de um driver primitivo.

[DefaultInstall] | 
[DefaultInstall.nt] | 
[DefaultInstall.ntx86] | 
[DefaultInstall.ntia64] | (Windows XP and later versions of Windows)
[DefaultInstall.ntamd64] | (Windows XP and later versions of Windows)
[DefaultInstall.ntarm] | (Windows 8 and later versions of Windows)
[DefaultInstall.ntarm64] (Windows 10 version 1709 and later versions of Windows)
 
[CopyFiles=@filename | file-list-section[,file-list-section] ...]
[CopyINF=filename1.inf[,filename2.inf]...]
[AddReg=add-registry-section[,add-registry-section]...]
[Include=filename1.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]...]
[ProfileItems=profile-items-section[,profile-items-section]...]
[UpdateInis=update-ini-section[,update-ini-section]...]
[UpdateIniFields=update-inifields-section[,update-inifields-section]...]
[Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...]
[RegisterDlls=register-dll-section[,register-dll-section]...]
[UnregisterDlls=unregister-dll-section[,unregister-dll-section]...] ...

Entradas

Nem todas as entradas válidas são suportadas num FIN Universal. Segue-se a lista quais diretivas são válidas num INF universal e quais não são.

Suportado num INF Universal

CopyFiles=@nome | ficheiro-lista-secção[,ficheiro-lista-secção] ...
Esta diretiva opcional especifica ou um ficheiro nomeado a ser copiado do meio de origem para o destino, ou faz referência a uma ou mais secções definidas pelo escritor INF que especificam ficheiros a transferir do meio de origem para o destino.

A entrada DefaultDestDir na secção DestinationDirs do INF especifica o destino para qualquer ficheiro a ser copiado. As secções SourceDisksNames e SourceDisksFiles , ou um INF adicional especificado na entrada LayoutFile da secção Version deste INF, fornecem a localização nos meios de distribuição dos ficheiros do driver.

Para mais informações, consulte a Diretiva INF CopyFiles.

CopyINF=nome do ficheiro1.inf[,nome do ficheiro2.inf]...
(Windows XP e versões posteriores do Windows.) Esta diretiva faz com que ficheiros INF especificados sejam copiados para o sistema de destino.

Para mais informações, consulte a Diretiva INF CopyINF.

AddReg=add-registry-section[,add-registry-section]...
Esta diretiva refere-se a uma ou mais secções definidas pelo escritor INF nas quais novas subchaves, possivelmente com entradas de valor iniciais, são especificadas para serem escritas no registo ou nas quais as entradas de valor das chaves existentes são modificadas.

Para mais informações, consulte a Diretiva INF AddReg.

Include=nome do ficheiro1.inf[,nome do ficheiro2.inf]...
Esta entrada opcional especifica um ou mais ficheiros INF adicionais fornecidos pelo sistema que contêm as secções necessárias para instalar este dispositivo e/ou driver. Se esta entrada for especificada, normalmente também é uma entrada de Necessidades .

Por exemplo, os ficheiros INF do sistema para drivers de dispositivo que dependem do suporte ao kernel-streaming do sistema especificam esta entrada da seguinte forma:

Include= ks.inf,kscaptur.inf,ksfilter.inf

Needs=inf-section-name[,inf-section-name]...
Esta entrada opcional especifica secções dentro dos ficheiros INF fornecidos pelo sistema que devem ser processadas durante a instalação deste dispositivo. Normalmente, tal secção nomeada é uma secção DDInstall (ou DDInstall.xxx) dentro de um dos ficheiros INF listados numa entrada Inclui. No entanto, pode ser qualquer secção referenciada dentro de tal DDInstall ou DDInstall.xxx secção do INF incluído.

Por exemplo, os ficheiros INF para drivers de dispositivo que têm a entrada Include anterior especificam esta entrada da seguinte forma:

Needs= KS.Registration,KSCAPTUR.Registration.NT,MSPCLOCK.Installation

Não suportado num INF Universal

Delfiles=ficheiro-lista-secção[,ficheiro-lista-secção]...
Esta diretiva faz referência a uma ou mais secções definidas pelo autor INF que listam ficheiros no alvo a eliminar.

Para mais informações, consulte a Diretiva INF DelFiles.

Renficheiros=secção-lista-de ficheiros[,secção-lista-dosseiro]...
Esta diretiva faz referência a uma ou mais secções definidas pelo escritor INF que listam ficheiros a serem renomeados no destino antes de os ficheiros fonte relevantes para o dispositivo serem copiados para o computador de destino.

Para mais informações, consulte a Diretiva INF RenFiles.

DelReg=del-registry-section[,del-registry-section]...
Esta diretiva refere-se a uma ou mais secções definidas pelo autor INF nas quais chaves e/ou entradas de valor são especificadas para serem removidas do registo durante a instalação dos dispositivos.

Para mais informações, consulte a Diretiva INF DelReg.

BitReg=bit-registry-section[,bit-registry-section]...
Esta diretiva refere-se a uma ou mais secções definidas pelo escritor INF nas quais as entradas existentes do valor do registo do tipo REG_BINARY são modificadas. Para mais informações, consulte a Diretiva INF AddReg.

Para mais informações, consulte a Diretiva INF BitReg.

ItensPerfil=secção-itens-perfil[,secção-itens-perfil]...
Esta diretiva refere-se a uma ou mais secções definidas pelo autor INF que descrevem itens a serem adicionados ou removidos do menu Iniciar.

Para mais informações, consulte a Diretiva INF ProfileItems.

UpdateInis=update-ini-section[,update-ini-section]...
Esta diretiva raramente usada refere uma ou mais secções definidas pelo escritor INF, especificando um ficheiro INI de origem a partir do qual uma secção ou linha específica dentro dessa secção deve ser lida num ficheiro INI de destino com o mesmo nome durante a instalação. Opcionalmente, modificações linha a linha a um ficheiro INI existente no destino a partir de um ficheiro INI de origem especificado com o mesmo nome podem ser especificadas na secção update-ini.

Para mais informações, consulte a Diretiva INF UpdateIs.

UpdateIniFields=update-inifields-section[,update-inifields-section]...
Esta diretiva raramente usada refere uma ou mais secções definidas pelo criador INF nas quais são especificadas modificações dentro das linhas de um ficheiro INI específico do dispositivo.

Para mais informações, consulte a Diretiva INF UpdateIniFields.

Ini2Reg=ini-para-registo-secção[,ini-para-registo-secção]...
Esta diretiva raramente usada refere-se a uma ou mais secções definidas pelo gravador INF nas quais secções ou linhas de um ficheiro INI específico do dispositivo, fornecidas no suporte de origem, devem ser movidas para o registo.

Para mais informações, consulte a Diretiva INF Ini2Reg.

RegisterDlls=register-dll-section[,register-dll-section]...
Esta diretiva refere-se a uma ou mais secções INF usadas para especificar ficheiros que são controlos OLE e que exigem auto-registo.

Para mais informações, consulte a Diretiva INF RegisterDlls.

UnregisterDlls=unregister-dll-section[,unregister-dll-section]...
Esta diretiva refere-se a uma ou mais secções INF usadas para especificar ficheiros que são controlos OLE e que exigem auto-desregisto (auto-remoção).

Para mais informações, consulte a Diretiva INF UnregisterDlls.

Remarks

As secções DefaultInstall não devem ser usadas para instalações de dispositivos. Use as secções DefaultInstall apenas para a instalação de drivers de filtro de classe, filtros do sistema de ficheiros e serviços de drivers do kernel que não estejam associados a um nó de dispositivo (devnode).

Se usar o DefaultInstall no Windows 10 versão 1903 e versões posteriores do Windows, recomenda-se que o ficheiro INF cumpra os requisitos de um driver primitivo.

Note

O ficheiro INF de um pacote de drivers que tem uma secção Fabricante não deve conter uma secção INF DefaultInstall se o pacote de driver for para ser assinado digitalmente. Para mais informações sobre assinatura de pacotes de condutores, consulte Assinatura de Condutores.

Note

Ao contrário de uma secção DDInstall , uma secção DefaultInstall não pode conter diretivas DriverVer ou LogConfig .

Para instalar uma secção DefaultInstall a partir de uma aplicação de instalação de dispositivo, utilize a seguinte chamada para InstallHinfSection:

InstallHinfSection(NULL,NULL,TEXT("DefaultInstall 132 path-to-inf\infname.inf"),0); 

Para mais informações sobre como utilizar as extensões .nt, .ntx86, .ntia64, .ntamd64, .ntarm e .ntarm64 , definidas pelo sistema, consulte Criação de Ficheiros INF para Múltiplas Plataformas e Sistemas Operativos.

Examples

O exemplo seguinte mostra uma secção típica do DefaultInstall :

[DefaultInstall]
CopyFiles=MyAppWinFiles, MyAppSysFiles, @SRSutil.exe
AddReg=MyAppRegEntries

Ver também

DDInstall

DriverVer

LogConfig