Seção INF DDInstall.HW
DDInstall. As seções HW normalmente são usadas para instalar dispositivos multifuncionais, para instalar drivers de filtro PnP e para configurar qualquer informação específica do dispositivo acessível pelo usuário, mas independente do driver no registro, seja com diretivas AddReg explícitas ou com entradas Include e Needs .
[install-section-name.HW] |
[install-section-name.nt.HW] |
[install-section-name.ntx86.HW] |
[install-section-name.ntia64.HW] | (Windows XP and later versions of Windows)
[install-section-name.ntamd64.HW] | (Windows XP and later versions of Windows)
[install-section-name.ntarm.HW] | (Windows 8 and later versions of Windows)
[install-section-name.ntarm64.HW] (Windows 10 version 1709 and later versions of Windows)
[AddReg=add-registry-section[,add-registry-section]...] ...
[Include=filename.inf[,filename2.inf]...]
[Needs=inf-section-name[,inf-section-name]...]
[DelReg=del-registry-section[,del-registry-section]...] ...
[BitReg=bit-registry-section[,bit-registry-section] ...]
Entradas
Nem todas as entradas válidas têm suporte em um INF Universal. O a seguir lista quais diretivas são válidas em um INF universal e quais não são.
Com suporte em um INF Universal
AddReg=add-registry-section[,add-registry-section]...
Faz referência a uma ou mais seções de add-registry definidas pelo gravador INF em outro lugar no arquivo INF para os dispositivos cobertos por esse DDInstall. Seção HW . A seção add-registry normalmente instala filtros e/ou armazena informações por dispositivo no registro. Uma especificação HKR em tal seção add-registry especifica a chave de hardware do dispositivo, uma subchave de registro específica do dispositivo que contém informações sobre o dispositivo. Uma chave de hardware também é chamada de chave do dispositivo. Para obter mais informações, consulte Árvores e chaves do Registro para dispositivos e drivers. Um pacote de driver pode adicionar configurações por meio de um INF usando uma especificação HKR em uma seção add-registry referenciada por uma seção DDInstall.HW.
Para obter mais informações, consulte Diretiva InF AddReg.
Include=filename. inf[,filename2.inf]...
Especifica um ou mais arquivos INF adicionais fornecidos pelo sistema que contêm seções necessárias para instalar esse dispositivo. Se essa entrada for especificada, geralmente é uma entrada Needs .
Needs=inf-section-name[,inf-section-name]...
Especifica as seções nomeadas que devem ser processadas durante a instalação deste dispositivo. Normalmente, essa seção nomeada é uma DDInstall. Seção HW em um arquivo INF fornecido pelo sistema listado em uma entrada Include . No entanto, pode ser qualquer seção referenciada dentro desse DDInstall. Seção HW do INF incluído.
Sem suporte em um INF Universal
DelReg=del-registry-section[,del-registry-section]...
Faz referência a uma ou mais seções delete-registry-sectiondefinidas pelo inf-writer em outro lugar no arquivo INF para os drivers dos dispositivos cobertos por esta seção DDInstall . Essa seção delete-registry remove informações obsoletas do Registro para um dispositivo/driver instalado anteriormente do computador de destino. Uma especificação HKR em uma seção delete-registry designa a mesma subchave que para AddReg.
Essa diretiva raramente é usada, exceto em um arquivo INF que atualiza uma instalação anterior dos mesmos dispositivos/modelos listados na seção por fabricante por modelos que definiu o nome desta seção DDInstall . Para obter mais informações, consulte Diretiva INF DelReg.
BitReg=bit-registry-section[,bit-registry-section] ...
É válido nesta seção, mas quase nunca usado. Uma especificação HKR em uma seção referenciada do registro de bits designa a mesma subchave que para AddReg. Para obter mais informações, consulte Diretiva INF BitReg.
Comentários
As extensões que não diferenciam maiúsculas de minúsculas para install-section-name mostradas na instrução de sintaxe formal podem ser inseridas nesse DDInstall. Nome da seção HW em arquivos INF multiplataforma. Para obter mais informações sobre como usar as extensões .nt, .ntx86, .ntia64, .ntamd64, .ntarm e .ntarm64 definidas pelo sistema, consulte Criando arquivos INF para várias plataformas e sistemas operacionais.
Qualquer DDInstall. A seção HW deve ter um dos seguintes:
- Uma diretiva AddReg .
- Uma entrada Include que especifica outro arquivo INF. Nesse caso, o DDInstall. A seção HW também deve conter uma entrada Needs correspondente que especifique uma seção no outro arquivo INF. Esta seção é usada para configurar as informações necessárias do Registro.
Cada diretiva em uma DDInstall. A seção HW pode fazer referência a mais de uma seção definida pelo gravador INF. No entanto, cada seção nomeada adicional deve ser separada da próxima com uma vírgula (,).
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 de sintaxe geral para arquivos INF.
Para obter mais informações sobre como instalar dispositivos multifuncionais, consulte Suporte a dispositivos multifuncionais.
Exemplos
Este exemplo mostra como um pacote de driver pode usar o DDInstall. Seções HW e DDInstall. Seções de serviços para adicionar um driver de função e um driver de filtro superior PnP.
[Example_DDInstall]
CopyFiles=example_copyfiles
[Example_DDInstall.HW]
AddReg=filter_addreg
[filter_addreg]
HKR,,"UpperFilters",0x00010000,"ExampleUpperFilter" ; [REG_MULTI_SZ](https://learn.microsoft.com/windows/desktop/SysInfo/registry-value-types) value
[Example_DDInstall.Services]
AddService=ExampleFunctionDriver,0x00000002,function_ServiceInstallSection
AddService=ExampleUpperFilter,,filter_ServiceInstallSection
[function_ServiceInstallSection]
DisplayName = %function_ServiceDesc%
ServiceType = 1
StartType = 3
ErrorControl = 1
ServiceBinary = %13%\ExampleFunctionDriver.sys
[filter_ServiceInstallSection]
DisplayName = %filter_ServiceDesc%
ServiceType = 1
StartType = 3
ErrorControl = 1
ServiceBinary = %13%\ExampleUpperFilter.sys