Directiva UpdateIniFields de INF
Precaución
A partir de Windows 11 versión 22H2, un paquete de controladores que usa esta directiva ya no es apto para una firma del Centro para desarrolladores de hardware.
Los paquetes de controladores universales y los controladores de Windows no pueden usar esta directiva.
Una directiva UpdateIniFields hace referencia a una o varias secciones con nombre en las que se pueden especificar modificaciones específicas dentro de las líneas de un archivo INI.
[DDInstall] |
[DDInstall.CoInstallers] |
[ClassInstall32] |
[ClassInstall32.ntx86] |
[ClassInstall32.ntia64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntamd64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntarm] | (Windows 8 and later versions of Windows)
[ClassInstall32.ntarm64] (Windows 10 version 1709 and later versions of Windows)
UpdateIniFields=update-inifields-section[,update-inifields-section]...
Cada sección con nombre a la que hace referencia una directiva UpdateIniFields tiene el siguiente formato:
[update-inifields-section]
ini-file,ini-section,profile-name[,old-field][,new-field][,flags]
...
Una update-inifields-section puede tener cualquier número determinado de entradas INF-writer-determined, cada una en una línea independiente.
Entries
ini-file
Especifica el nombre de un archivo INI proporcionado en el medio de origen e, implícitamente, el del archivo INI que se va a actualizar en el equipo de destino. Este valor se puede expresar como un filename o como un token %strkey% que se define en una sección Strings del archivo INF.
ini-section
Especifica el nombre de la sección dentro de los archivos INI especificados que contiene la línea que se va a modificar.
profile-name
Especifica el nombre de la línea que se va a modificar dentro de la sección INI especificada. Se debe especificar al menos una de las entradas old-field o new-field para realizar una modificación de esta línea.
old-field
Especifica un campo existente dentro de la línea especificada. Si se omite new-field de esta entrada de sección, este campo se elimina de la línea especificada. De lo contrario, el valor de new-field especificado debe reemplazar este campo.
new-field
Especifica un reemplazo de un old-field determinado o, si se omite old-field, una adición a la línea especificada.
flags
Especifica (en el bit 0) cómo interpretar old-field o new-field si cualquier de ellos o ambos contienen un asterisco (*), o (en el bit 1) que carácter separador se va a usar al anexar un new-field determinado a la línea especificada, como se indica a continuación:
Bit cero = 0
Interpreta cualquier asterisco (*) en las entradas old-field o new-field especificadas literalmente, no como carácter comodín, al buscar una coincidencia en la línea especificada del archivo INI. Este es el valor predeterminado.
Bit cero = 1
Interpreta cualquier asterisco (*) en las entradas old-field o new-field especificadas como un carácter comodín, al buscar una coincidencia en la línea especificada del archivo INI.
Bit uno = 0
Usa un carácter de espacio como separador al agregar la entrada new-field especificada a la línea especificada del archivo INI. Este es el valor predeterminado.
Bit uno = 1
Usa una coma (,) como separador al agregar la entrada new-field especificada a la línea especificada del archivo INI.
Comentarios
La directiva UpdateIniFields casi nunca se especifica en archivos INF para instalaciones en Windows porque no es necesario tener archivos INI en sus medios de distribución. Sin embargo, la directiva UpdateIniFields es válida en cualquiera de las secciones que se muestran en la instrucción de sintaxis formal, así como en las secciones INF-writer-defined a las que hace referencia una directiva AddInterface o a las que se hace referencia en una sección InterfaceInstall32.
Cada nombre de update-inifields-section debe ser único para el archivo INF. Cada nombre de sección INF-writer-created 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, consulte Reglas generales de sintaxis para archivos INF.
A diferencia de una sección a la que hace referencia la directiva UpdateInis, una sección a la que hace referencia UpdateIniFields reemplaza, agrega o elimina partes de una línea de un archivo INI existente en lugar de afectar al valor completo de una línea determinada. Se debe especificar al menos uno de los valores de old-field o new-field en cada entrada de la sección.
Cualquier comentario en una línea de archivo INI que se vaya a modificar se elimina porque podría no ser aplicable después de los cambios realizados según esta sección. Al buscar campos en la línea de los archivos INI, los espacios, las pestañas y las comas se interpretan como delimitadores de campo. Sin embargo, se usa un carácter de espacio como separador predeterminado cuando se anexa un nuevo campo a una línea.
El INF proporciona la ruta de acceso completa del ini-file especificado en el medio de distribución de una de las maneras siguientes:
En los archivos INF proporcionados por IHV/OEM, mediante SourceDisksNames y, posiblemente, las secciones SourceDisksFiles de este INF especifican explícitamente la ruta de acceso completa de cada archivo de origen con nombre que no está en el directorio o directorios raíz en el medio de distribución.
En los archivos INF proporcionados por el sistema, proporcionando uno o varios archivos INF adicionales, identificados en la entrada LayoutFile de la sección Version del archivo INF.