Secção INF DDInstall.HW

DDInstall. As secções HW são tipicamente usadas para instalar dispositivos multifunções, para instalar drivers de filtro PnP e para configurar qualquer informação específica de dispositivo acessível ao utilizador, mas independente do driver, no registo, seja com diretivas explícitas do AddReg ou com entradas Incluir e Necessidades .

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

AddReg=add-registry-section[,add-registry-section]...
Faz referência a uma ou mais secções de registo de adição definidas pelo escritor INF noutras partes do ficheiro INF para os dispositivos abrangidos por esta secção DDInstall. HW . A secção de adicionar registo normalmente instala filtros e/ou armazena informação por dispositivo no registo. Uma especificação HKR numa secção de registo adicional especifica a chave de hardware do dispositivo, uma subchave de registo específica do dispositivo que contém informações sobre o dispositivo. Uma chave de hardware também é chamada de chave de dispositivo. Para mais informações, consulte Árvores de Registo e Chaves para Dispositivos e Controladores. Um pacote de drivers pode adicionar definições através de um INF usando uma especificação HKR numa secção de registo adicional referenciada por uma secção DDInstall.HW.

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

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

Needs=inf-section-name[,inf-section-name]...
Especifica as secções nomeadas que devem ser processadas durante a instalação deste dispositivo. Normalmente, tal secção nomeada é uma secção DDInstall. HW dentro de um ficheiro INF fornecido pelo sistema, listado numa entrada Inclui . No entanto, pode ser qualquer secção referenciada dentro desse DDInstall. Secção HW do INF incluído.

Não suportado num INF Universal

DelReg=del-registry-section[,del-registry-section]...
Faz referência a uma ou mais secções de exclusão do registodefinidas pelo escritor INF noutras partes do ficheiro INF para os drivers dos dispositivos abrangidos por esta secção DDInstall . Uma secção de exclusão de registo remove informação obsoleta do registo de um dispositivo/driver previamente instalado do computador de destino. Uma especificação HKR , numa secção de registo de eliminação, designa a mesma subchave que para o AddReg.

Esta diretiva raramente é usada, exceto num ficheiro INF que atualiza uma instalação anterior dos mesmos dispositivos/modelos listados na secção por fabricante por modelos que definiu o nome desta secção DDInstall . Para mais informações, consulte a Diretiva INF DelReg.

BitReg=secção-registo-de bits[,secção-registo-de bits] ...
É válido nesta secção, mas quase nunca é usado. Uma especificação HKR numa secção de registo de bits referenciada designa a mesma subchave que para o AddReg. Para mais informações, consulte a Diretiva INF BitReg.

Remarks

As extensões insensíveis a maiúsculas minúsculas ao nome da secção de instalação apresentadas na instrução sintática formal podem ser inseridas num DDInstall. Nome da secção HW em ficheiros INF multiplataforma. 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.

Qualquer secção DDInstall. HW deve ter uma das seguintes características:

• Uma diretiva do AddReg .
• Uma entrada Include que especifica outro ficheiro INF. Neste caso, a secção DDInstall. HW deve também conter uma entrada correspondente Needs que especifique uma secção no outro ficheiro INF. Esta secção é usada para configurar a informação necessária do registo.

Cada diretiva numa secção DDInstall. HW pode referenciar mais do que uma secção definida pelo escritor INF. No entanto, cada secção adicional nomeada deve ser separada da seguinte por uma vírgula (,).

Cada nome de secção deve ser único dentro do ficheiro INF e deve seguir as regras gerais para definir nomes de secção. Para mais informações sobre estas regras, consulte Regras Gerais de Sintaxe para Ficheiros INF.

Para mais informações sobre como instalar dispositivos multifunções, consulte Suporte a Dispositivos Multifunções.

Examples

Este exemplo mostra como um pacote de drivers pode usar as secções DDInstall. HW e DDInstall. Secções de serviços para adicionar tanto um controlador de funções como um controlador 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

Ver também

AddReg

BitReg

DDInstall

Serviços DDInstall.

DelReg