Sección INF DDInstall.HW

DDInstall. Las secciones HW se usan normalmente para instalar dispositivos multifunción, para instalar controladores de filtro PnP y para configurar cualquier información específica del dispositivo pero independiente del controlador del usuario en el Registro, ya sea con directivas AddReg explícitas o con entradas Include y 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

No todas las entradas válidas se admiten en un INF universal. A continuación se enumeran las directivas que son válidas en un INF universal y que no lo son.

Compatible con un INF universal

AddReg=add-registry-section[,add-registry-section]...
Hace referencia a una o varias secciones de add-registry-fined de INF-writer en otra parte del archivo INF para los dispositivos cubiertos por este DDInstall. Sección HW . Normalmente, la sección add-registry instala filtros o almacena información por dispositivo en el Registro. Una especificación HKR de este tipo de sección add-registry especifica la clave de hardware del dispositivo, una subclave del Registro específica del dispositivo que contiene información sobre el dispositivo. Una clave de hardware también se denomina clave de dispositivo. Para obtener más información, consulta Árboles y claves del Registro para dispositivos y controladores. Un paquete de controladores puede agregar la configuración a través de un INF mediante una especificación HKR en una sección del registro de complementos a la que hace referencia una sección DDInstall.HW.

Para obtener más información, vea Inf AddReg (Directiva AddReg de INF).

Include=filename. inf[,filename2.inf]...
Especifica uno o varios archivos INF adicionales proporcionados por el sistema que contienen secciones necesarias para instalar este dispositivo. Si se especifica esta entrada, normalmente es una entrada Needs .

Needs=inf-section-name[,inf-section-name]...
Especifica las secciones con nombre que se deben procesar durante la instalación de este dispositivo. Normalmente, esta sección con nombre es DDInstall. Sección HW dentro de un archivo INF proporcionado por el sistema que aparece en una entrada Include . Sin embargo, puede ser cualquier sección a la que se haga referencia dentro de este tipo DDInstall. Sección HW del INF incluido.

No se admite en un INF universal

DelReg=del-registry-section[,del-registry-section]...
Hace referencia a una o varias secciones delete-registry-definidas por INF-writer enotra parte del archivo INF para los controladores de los dispositivos cubiertos por esta sección DDInstall . Esta sección delete-registry elimina la información del Registro obsoleta de un dispositivo o controlador instalado previamente del equipo de destino. Una especificación HKR de esta sección delete-registry designa la misma subclave que para AddReg.

Esta directiva rara vez se usa, excepto en un archivo INF que actualiza una instalación anterior de los mismos dispositivos o modelos enumerados en la sección por fabricante por modelo que definió el nombre de esta sección DDInstall . Para obtener más información, vea INF DelReg Directive.

BitReg=bit-registry-section[,bit-registry-section] ...
Es válido en esta sección, pero casi nunca se usa. Una especificación HKR en una sección de registro de bits a la que se hace referencia designa la misma subclave que para AddReg. Para obtener más información, consulte Inf BitReg Directive.

Remarks

Las extensiones que no distinguen mayúsculas de minúsculas al nombre de la sección install-section que se muestra en la instrucción de sintaxis formal se pueden insertar en dicho DDInstall. Nombre de sección de HW en archivos INF multiplataforma. Para obtener más información sobre cómo usar las extensiones .nt, .ntx86, .ntia64, .ntamd64, .ntarm y .ntarm64 definidas por el sistema, vea Creación de archivos INF para varias plataformas y sistemas operativos.

Cualquier DDInstall. La sección HW debe tener una de las siguientes opciones:

• Una directiva AddReg .
• Entrada Include que especifica otro archivo INF. En este caso, DDInstall. La sección HW también debe contener una entrada Needs correspondiente que especifique una sección en el otro archivo INF. Esta sección se usa para configurar la información del Registro necesaria.

Cada directiva de un DDInstall. La sección HW puede hacer referencia a más de una sección definida por INF-writer. Sin embargo, cada sección con nombre adicional debe estar separada del siguiente con una coma (,).

Cada nombre de sección de este tipo debe ser único dentro del archivo INF y debe seguir las reglas generales para definir nombres de sección. Para obtener más información sobre estas reglas, vea Reglas de sintaxis general para archivos INF.

Para obtener más información sobre cómo instalar dispositivos multifunción, vea Compatibilidad con dispositivos multifunción.

Examples

En este ejemplo se muestra cómo un paquete de controladores puede usar DDInstall. Secciones de HW y DDInstall. Secciones de servicios para agregar un controlador de función y un 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

Consulte también

AddReg

BitReg

DDInstall

DDInstall.Services

DelReg