Sección INF DDInstall.HW
DDInstall. Las secciones HW se suelen usar para instalar dispositivos multifunción, para instalar controladores de filtro PnP y para configurar cualquier información específica del dispositivo accesible para el usuario, pero independiente del controlador 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.
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 . La sección add-registry normalmente instala filtros o almacena información por dispositivo en el registro. Una especificación HKR en esta sección add-registry-section 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 de registro de complemento a la que hace referencia una sección DDInstall.HW.
Para obtener más información, vea Inf AddReg Directive.
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 un DDInstall de este tipo. 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-definidaspor INF-writer en otra 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 en una sección de registro de eliminación 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, vea Inf BitReg Directive.
Comentarios
Las extensiones que no distinguen mayúsculas de minúsculas al nombre install-section-name que se muestra en la instrucción de sintaxis formal se pueden insertar en este tipo de DDInstall. Nombre de sección de HW en archivos INF multiplataforma. Para obtener más información sobre cómo usar las extensiones .nt, .nt, .ntx86, .ntia64, .ntamd64, .ntarm y .ntarm64 , vea Creating INF Files for Multiple Platforms and Operating Systems.
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 de la 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, consulte Compatibilidad con dispositivos multifunción.
Ejemplos
En este ejemplo se muestra cómo un paquete de controladores puede usar DDInstall. Secciones 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