Secção INF DDInstall
Cada seção por modelo DDInstall contém uma diretiva DriverVer opcional e uma ou mais diretivas que fazem referência a seções nomeadas adicionais no arquivo INF, mostradas aqui com as diretivas INF especificadas com mais freqüência, CopyFiles e AddReg, listadas primeiro.
As seções referenciadas por essas diretivas contêm instruções para instalar arquivos de driver e gravar qualquer informação específica do dispositivo e/ou do driver no registro.
[install-section-name] |
[install-section-name.nt] |
[install-section-name.ntx86] |
[install-section-name.ntia64] | (Windows XP and later versions of Windows)
[install-section-name.ntamd64] | (Windows XP and later versions of Windows)
[install-section-name.ntarm] | (Windows 8 and later versions of Windows)
[install-section-name.ntarm64] (Windows 10 version 1709 and later versions of Windows)
[DriverVer=mm/dd/yyyy[,x.y.v.z]]
[CopyFiles=@filename | file-list-section[,file-list-section] ...]
[CopyINF=filename1.inf[,filename2.inf]...] (Windows XP and later versions of Windows)
[AddReg=add-registry-section[,add-registry-section]...]
[AddProperty=add-property-section[,add-property-section]...] (Windows Vista and later versions of Windows)
[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]...]
[DelProperty=del-property-section[,del-property-section]...] (Windows Vista and later versions of Windows)
[FeatureScore=featurescore]... (Windows Vista and later versions of Windows)
[BitReg=bit-registry-section[,bit-registry-section]...]
[LogConfig=log-config-section[,log-config-section]...]
[ProfileItems=profile-items-section[,profile-items-section]...] (Windows 2000 and later versions of Windows)
[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]...]
[ExcludeID=device-identification-string[,device-identification-string]...]... ((Windows XP and later versions of Windows)
[Reboot]
Inscrições
Nem todas as entradas válidas são suportadas em um Universal INF. Segue-se uma lista das diretivas que são válidas num INF universal e quais não o são.
Suportado em um INF Universal
DriverVer=mm/dd/aaaa[,x.y.v.z]
Esta entrada opcional especifica informações de versão para o pacote de driver .
Para obter informações sobre como especificar essa entrada, consulte Diretiva INF DriverVer.
CopyFiles=@nome do arquivo | file-list-section[,file-list-section] ...
Esta diretiva especifica um arquivo nomeado a ser copiado da mídia de origem para o destino ou faz referência a uma ou mais seções definidas pelo gravador INF nas quais os arquivos relevantes para o dispositivo na mídia de origem são especificados para transferência para o destino. A diretiva CopyFiles é opcional, mas está presente na maioria das seções DDInstall.
A entrada
Para obter mais informações, consulte Diretiva INF CopyFiles.
CopyINF=filename1.inf[,filename2.inf]...
(Windows XP e posterior) Esta diretiva faz com que os arquivos INF especificados sejam copiados para o sistema de destino.
Para obter mais informações, consulte Diretiva INF CopyINF.
AddReg=add-registry-section[,add-registry-section]...
Esta diretiva faz referência a uma ou mais seções definidas pelo gravador INF nas quais novas subchaves, possivelmente com entradas de valor inicial, são especificadas para serem gravadas no registro ou nas quais as entradas de valor de chaves existentes são modificadas.
Uma especificação de HKR
Para obter mais informações, consulte Diretiva INF AddReg.
AddProperty=add-property-section[,add-property-section]...
(Windows Vista e posterior) Faz referência a uma ou mais seções de arquivo INF que modificam propriedades do dispositivo definidas para uma instância de dispositivo. Você deve usar uma diretiva INF AddProperty apenas para definir uma propriedade de instância de dispositivo que seja nova no Windows Vista ou em versões posteriores dos sistemas operacionais Windows.
Para propriedades de instância de dispositivo que foram introduzidas anteriormente no Windows Server 2003, Windows XP ou Windows 2000 e que têm valores de entrada do Registro correspondentes, você deve continuar a usar diretivas INF AddReg para definir as propriedades da instância do dispositivo. Estas diretrizes aplicam-se a propriedades definidas pelo sistema e propriedades personalizadas. Para obter mais informações sobre como usar a diretiva AddProperty, consulte Usando a Diretiva INF AddProperty e a Diretiva INF DelProperty.
Include=filename1.inf[,filename2.inf]...
Esta entrada opcional especifica um ou mais arquivos INF adicionais fornecidos pelo sistema que contêm seções necessárias para instalar este dispositivo e/ou driver. Se esta entrada for especificada, geralmente também é uma entrada Needs.
Por exemplo, arquivos INF para drivers de dispositivo que dependem do suporte de streaming de kernel do sistema podem especificar essa entrada da seguinte maneira:
Include= ks.inf, kscaptur.inf, ksfilter.inf
Needs=inf-section-name[,inf-section-name]...
Esta entrada opcional especifica seções dentro de arquivos INF fornecidos pelo sistema que devem ser processados durante a instalação deste dispositivo. Normalmente, essa seção nomeada é uma seção DDInstall (ou DDInstall.xxx) dentro de um dos arquivos INF listados em uma entrada Include. No entanto, pode ser qualquer seção que seja referenciada dentro de tal DDInstall ou DDInstall.xxx secção do INF incluído.
Por exemplo, os arquivos INF para drivers de dispositivo que têm a entrada Include
Needs= KS.Registration, KSCAPTUR.Registration.NT, MSPCLOCK.Installation
FeatureScore=featurescore
Advertência
A diretiva
(Windows Vista e posterior) Esta diretiva fornece um critério de classificação adicional para os condutores que se baseiam nas características suportadas por um condutor. Por exemplo, pontuações de recursos podem ser definidas para uma classe de configuração de dispositivo que distingue entre drivers com base em critérios específicos da classe.
Para obter mais informações sobre como os drivers são classificados, consulte Como o Windows classifica drivers (Windows Vista e posterior).
Para obter mais informações sobre esta diretiva, consulte INF FeatureScore Directive.
Observação
Embora uma seção
ExcludeID=device-identification-string[,device-identification-string]...
Advertência
A diretiva
(Windows XP e posterior) Esta diretiva especifica uma ou mais cadeias de identificação de dispositivos (IDs de hardware ou IDs compatíveis ). A seção DDInstall não instala dispositivos que tenham IDs de dispositivo que correspondam a qualquer uma das IDs de hardware ou IDs compatíveis listadas.
Reboot
Esta diretiva indica que o chamador deve ser solicitado a reiniciar o sistema após a conclusão da instalação.
Para obter mais informações, consulte Diretiva de reinicialização INF.
Não suportado em um INF Universal
Delfiles=file-list-section[,file-list-section]...
Esta diretiva faz referência a uma ou mais seções definidas pelo gravador INF listando arquivos no destino a ser excluído.
Para obter mais informações, consulte Diretiva INF DelFiles.
Renfiles=file-list-section[,file-list-section]...
Esta diretiva faz referência a uma ou mais seções definidas pelo gravador INF listando arquivos a serem renomeados no destino antes que os arquivos de origem relevantes para o dispositivo sejam copiados para o computador de destino.
Para obter mais informações, consulte Diretiva INF RenFiles.
DelReg=del-registry-section[,del-registry-section]...
Esta diretiva faz referência a uma ou mais seções definidas pelo gravador INF nas quais chaves e/ou entradas de valor são especificadas para serem removidas do registro durante a instalação dos dispositivos.
Normalmente, essa diretiva é usada para lidar com atualizações quando um INF deve limpar entradas de registro antigas de uma instalação anterior deste dispositivo.
Uma especificação de HKR
Para obter mais informações, consulte Diretiva INF DelReg.
DelProperty=del-property-section[,del-property-section]...
(Windows Vista e posterior) Faz referência a uma ou mais seções de arquivo INF que excluem propriedades do dispositivo definidas para uma instância de dispositivo. Você deve usar uma diretiva INF DelProperty apenas para excluir uma propriedade de instância de dispositivo que é nova no Windows Vista ou versões posteriores do Windows.
Para propriedades de instância de dispositivo que foram introduzidas anteriormente no Windows Server 2003, Windows XP ou Windows 2000 e que têm valores de entrada do Registro correspondentes, você deve continuar a usar diretivas INF DelReg para excluir as propriedades da instância do dispositivo. Estas diretrizes aplicam-se a propriedades definidas pelo sistema e propriedades personalizadas. Para obter mais informações sobre como usar a diretiva
BitReg=bit-registry-section[,bit-registry-section]...
Esta diretiva faz referência a uma ou mais seções definidas pelo gravador INF nas quais as entradas de valor do Registro existentes do tipo REG_BINARY são modificadas.
Uma especificação de HKR
Para obter mais informações, consulte Diretiva BitReg INF.
LogConfig=log-config-section[,log-config-section]...
Esta diretiva faz referência a uma ou mais seções definidas pelo gravador INF dentro de um INF para um dispositivo enumerado raiz ou para um dispositivo instalado manualmente. Nessas seções nomeadas, o INF para tal dispositivo "detetado" ou instalado manualmente especifica uma ou mais configurações lógicas de recursos de hardware relativos a barramento que o dispositivo deve ter para estar operacional. O INF para um dispositivo instalado manualmente que não seja configurável por software também deve ter um DDInstall. FactDef seção.
A diretiva LogConfig nunca é usada para instalar dispositivos Plug and Play (PnP). No entanto, você pode usar um INF DDInstall.LogConfigOverride seção para fornecer uma configuração de substituição para dispositivos PnP.
Esta diretiva é irrelevante para todos os controladores e componentes de nível superior (não relacionados com dispositivos).
Para obter mais informações, consulte Diretiva INF LogConfig.
ProfileItems=profile-items-section[,profile-items-section]...
(Microsoft Windows 2000 e versões posteriores do Windows) Essa diretiva raramente usada faz referência a uma ou mais seções definidas pelo gravador INF que descrevem itens a serem adicionados ou removidos do menu Iniciar.
Para obter mais informações, consulte Diretiva INF ProfileItems.
UpdateInis=update-ini-section[,update-ini-section]...
Essa diretiva raramente usada faz referência a uma ou mais seções definidas pelo gravador INF, especificando um arquivo INI de origem a partir do qual uma determinada seção ou linha dentro dessa seção deve ser lida em um arquivo INI de destino com o mesmo nome durante a instalação. Opcionalmente, modificações linha por linha em um arquivo INI existente no destino de um determinado arquivo INI de origem com o mesmo nome podem ser especificadas na seção update-ini.
Para obter mais informações, consulte Diretiva INF UpdateInis.
UpdateIniFields=update-inifields-section[,update-inifields-section]...
Essa diretiva raramente usada faz referência a uma ou mais seções definidas pelo gravador INF nas quais as modificações dentro das linhas de um arquivo INI específico do dispositivo são especificadas.
Para obter mais informações, consulte Diretiva INF UpdateIniFields.
Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...
Essa diretiva raramente usada faz referência a uma ou mais seções definidas pelo gravador INF nas quais seções ou linhas de um arquivo INI específico do dispositivo, fornecido na mídia de origem, devem ser movidas para o registro.
Para obter mais informações, consulte Diretiva INF Ini2Reg.
RegisterDlls=register-dll-section[,register-dll-section]...
Esta diretiva faz referência a uma ou mais seções INF usadas para especificar arquivos que são controles OLE e exigem auto-registro.
Para obter mais informações, consulte Diretiva INF RegisterDlls.
UnregisterDlls=unregister-dll-section[,unregister-dll-section]...
Esta diretiva faz referência a uma ou mais seções INF usadas para especificar arquivos que são controles OLE e exigem auto-cancelamento de registro (auto-remoção).
Para obter mais informações, consulte Diretiva INF UnregisterDlls.
Comentários
Em toda a documentação do Kit de Driver do Windows (WDK), o termo DDInstall é usado para se referir a um install-section-name , com ou sem extensões de plataforma. Portanto, "seção DDInstall" significa "uma seção nomeada dentro de um INF, com o formato [install-section-name] ou [install-section-name.ntxxx]". Ao criar nomes para seções de DDInstall, você deve incluir um prefixo específico do dispositivo, como [WDMPNPB003_Device] ou [GPR400. Install.NT].
Cada seção de DDInstall deve ser referenciada em uma entrada específica do dispositivo/modelos na seção por fabricante INF Models do arquivo INF.
Exceto para dispositivos que não têm arquivos associados a serem transferidos da mídia de origem, um arquivo INF que instala um driver WDM em diferentes plataformas de sistema operacional deve ter pelo menos uma das seguintes seções de
- Um install-section-nameseção de .ntx86 que especifica as entradas para instalações de dispositivo/driver específicas para plataformas baseadas em x86.
- Um install-section-nameseção .ntia64 que especifica as entradas para instalações de dispositivo/driver específicas para plataformas baseadas em Itanium.
- Um install-section-nameseção .ntamd64 que especifica as entradas para instalações de dispositivo/driver específicas para plataformas baseadas em x64.
- Um install-section-nameseção .ntarm que especifica as entradas para instalações de dispositivo/driver específicas para plataformas baseadas em Arm.
- Um install-section-nameseção .ntarm64 que especifica as entradas para instalações de dispositivo/driver específicas para plataformas baseadas em Arm64.
- Um install-section-name ou install-section-nameseção .nt que especifica as entradas para instalações de dispositivo/driver que não são específicas de uma plataforma de hardware específica.
Para obter mais informações sobre como usar o.nt
A partir do Windows 2000, um arquivo INF que instala drivers deve ter seções DDInstall.Services para especificar informações de serviço de driver.
Cada diretiva em uma seção
Cada nome de seção deve ser exclusivo dentro do arquivo INF e deve seguir as regras gerais para definir nomes de seção. Para obter mais informações sobre essas regras, consulte Regras gerais de sintaxe para arquivos INF.
Qualquer diretiva
Dependendo da classe de configuração do dispositivo especificada na seção Versão do INF, diretivas adicionais específicas de classe podem ser especificadas em uma seção DDInstall. Para obter mais informações sobre diretivas específicas de classe, consulte os seguintes tópicos:
- Criando um arquivo INF para um dispositivo Windows SideShow-Compatible
- seção DDInstall em um arquivo INF de rede
- arquivos INF para dispositivos de imagem estática
- arquivos INF para dispositivos WIA
- Requisitos de instalação para componentes de rede
- Especificando diretivas WDF em arquivos INF
Exemplos
Este exemplo mostra a expansão do DDInstall seções, Ser_Inst e Inp_Inst. Essas seções são referenciadas no exemplo para o INF Models seção.
[Ser_Inst]
CopyFiles=Ser_CopyFiles, mouclass_CopyFiles
[Ser_CopyFiles]
sermouse.sys
[mouclass_CopyFiles] ; section name referenced by > 1 CopyFiles
mouclass.sys
[Inp_Inst]
CopyFiles=Inp_CopyFiles, mouclass_CopyFiles
[Inp_CopyFiles]
inport.sys
O exemplo a seguir mostra a seção DDInstall de um arquivo INF que instala um driver WDM fornecido pelo sistema para um dispositivo de áudio em várias plataformas de sistema operacional:
[WDMPNPB003_Device.NT]
Include=ks.inf, wdmaudio.inf
Needs=KS.Registration, WDMAUDIO.Registration.NT
CopyFiles=MSSB16.CopyList
AddReg=WDM_SB16.AddReg
O exemplo a seguir mostra as seções referenciadas pela entrada anterior
[KS.Registration]
; following AddReg= is actually a single line in the ks.inf file
AddReg=ProxyRegistration,CategoryRegistration,\
TopologyNodeRegistration,PlugInRegistration,PinNameRegistration,\
DeviceRegistration
CopyFiles=KSProxy.Files,KSDriver.Files
[WDMAUDIO.Registration.NT]
AddReg=WDM.AddReg
CopyFiles=WDM.CopyFiles.Sys, WDM.CopyFiles.Drv
;
; INF-writer-defined add-registry and file-list sections
; referenced by preceding directives are omitted here for brevity
;