Sección INF InterfaceInstall32

Artículo
06/15/2023

En esta sección se crean una o varias clases de interfaz de dispositivo nuevas. Después de crear una nueva clase, los dispositivos o controladores instalados posteriormente pueden registrar la compatibilidad con la nueva clase de interfaz de dispositivo mediante una llamada a IoRegisterDeviceInterface.

[InterfaceInstall32]
 
{InterfaceClassGUID}=install-interface-section[,flags]
...

Entradas

InterfaceClassGUID
Especifica un valor GUID que identifica la clase de interfaz de dispositivo recién exportada.

Para registrar una instancia de la clase de interfaz, el controlador de un dispositivo debe llamar a IoRegisterDeviceInterface con este GUID. También se puede hacer referencia al valor GUID especificado de esta sección mediante una directiva ADDInterface inf en un DDInstall inf. Sección Interfaces.

Para obtener más información sobre cómo crear un GUID, consulte Uso de GUID en controladores. Para conocer los GUID de la clase de interfaz definida por el sistema, consulte los encabezados adecuados, como Ks.h para las interfaces de streaming de kernel.

install-interface-section
Hace referencia a una sección definida por INF-writer, posiblemente con cualquiera de las extensiones definidas por el sistema, en otra parte de este INF.

flags
Si se especifica, esta entrada debe ser cero.

Comentarios

Cuando un InterfaceClassGUID especificado aún no está instalado en el sistema, esa clase de interfaz se instala como el DDInstall correspondiente. La sección Interfaces se procesa durante la instalación del dispositivo o cuando el controlador del dispositivo realiza la llamada inicial a IoRegisterDeviceInterface.

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

Cualquier sección install-interface-section especificada tiene el siguiente formato general:

[interface-install-section] | 
[interface-install-section.nt] | 
[interface-install-section.ntx86] | 
[interface-install-section.ntia64] | (Windows XP and later versions of Windows)
[interface-install-section.ntamd64] | (Windows XP and later versions of Windows)
[interface-install-section.ntarm] | (Windows 8 and later versions of Windows)
[interface-install-section.ntarm64] (Windows 10 and later versions of Windows)
 
AddReg=add-registry-section[, add-registry-section] ...
[AddProperty=add-property-section[, add-property-section] ...]  (Windows Vista and later versions of Windows)
[Copyfiles=@filename | file-list-section[, file-list-section] ...]
[DelReg=del-registry-section[, del-registry-section] ...]
[DelProperty=del-property-section[, del-property-section] ...]  (Windows Vista and later versions of Windows)
[BitReg=bit-registry-section[,bit-registry-section]...]
[Delfiles=file-list section[, file-list-section] ...]
[Renfiles=file-list-section[, file-list-section] ...]
[UpdateInis=update-ini-section[,update-ini-section]...]
[UpdateIniFields=update-inifields-section[,update-inifields-section]...]
[Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...]
...

Para obtener más información sobre las entradas de la sección interface-install-section, vea INF DDInstall Section.

A partir de Windows Vista, puede establecer propiedades de clase de interfaz de dispositivo mediante la inclusión de directivas ADDProperty inf en una sección de instalación de interfaz. También puede eliminar las propiedades de la clase de interfaz de dispositivo mediante la inclusión de directivas INF DelProperty en una sección de instalación de interfaz. Sin embargo, debe usar una directiva AddProperty o DelProperty solo para modificar las propiedades de clase de interfaz de dispositivo que son nuevas en Windows Vista o versiones posteriores de los sistemas operativos Windows. En el caso de las propiedades de clase de interfaz de dispositivo que se introdujeron en Windows Server 2003, Windows XP o Windows 2000, y que tienen entradas de valor del Registro correspondientes, debe seguir usando directivas AddReg inf y directivas INF DelReg para establecer y eliminar las propiedades de la clase de interfaz de dispositivo. Estas directrices se aplican a las propiedades definidas por el sistema y a las propiedades personalizadas. Para obtener más información sobre cómo usar la directiva AddProperty y la directiva DelProperty , vea Using the INF AddProperty Directive and the INF DelProperty Directive.

Una directiva AddReg hace referencia a una o varias secciones del registro de complementos que establecen información específica de la interfaz de dispositivo en el Registro durante la instalación de esta interfaz.

La información del Registro sobre esta clase de interfaz debe incluir al menos un nombre descriptivo para la nueva clase de interfaz de dispositivo y cualquier información que necesiten los componentes de nivel superior cuando se abran y usen esta interfaz.

Además, una sección install-interface-section podría usar cualquiera de las directivas opcionales que se muestran aquí para especificar operaciones de instalación específicas de la interfaz.

Para obtener más información sobre cómo usar las extensiones . nt, .ntx86, .ntia64, .ntamd64, .ntarm, .ntarm, .ntarm64 , vea Creating INF Files for Multiple Platforms and Operating Systems.