Seção INTERFACEInstall32 do INF

Artigo
06/15/2023

Esta seção cria uma ou mais novas classes de interface do dispositivo. Depois que uma nova classe é criada, os dispositivos/drivers instalados posteriormente podem registrar suporte para a nova classe de interface do dispositivo chamando IoRegisterDeviceInterface.

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

Entradas

InterfaceClassGUID
Especifica um valor GUID que identifica a classe de interface do dispositivo recém-exportada.

Para registrar uma instância da classe de interface, o driver de um dispositivo deve chamar IoRegisterDeviceInterface com esse GUID. O valor guid especificado nesta seção também pode ser referenciado por uma diretiva AddInterface do INF em uma DDInstall inf. Seção Interfaces.

Para obter mais informações sobre como criar um GUID, consulte Usando GUIDs em drivers. Para o GUIDS da classe de interface definida pelo sistema, consulte os cabeçalhos apropriados, como Ks.h para as interfaces de streaming de kernel.

install-interface-section
Faz referência a uma seção definida pelo gravador INF, possivelmente com qualquer uma das extensões definidas pelo sistema, em outro lugar neste INF.

sinalizadores
Se especificada, essa entrada deve ser zero.

Comentários

Quando uma InterfaceClassGUID especificada ainda não está instalada no sistema, essa classe de interface é instalada como a DDInstall correspondente. A seção Interfaces é processada durante a instalação do dispositivo ou quando o driver desse dispositivo faz a chamada inicial para IoRegisterDeviceInterface.

Cada nome install-interface-section deve ser exclusivo dentro do arquivo INF e deve seguir as regras gerais para definir nomes de seção. Para obter mais informações sobre essas regras, consulte Regras gerais de sintaxe para arquivos INF.

Qualquer seção install-interface especificada tem o seguinte formulário geral:

[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 obter mais informações sobre as entradas na seção interface-install-section, consulte Seção INF DDInstall.

A partir do Windows Vista, você pode definir as propriedades da classe de interface do dispositivo , incluindo as diretivas AddProperty do INF em uma seção de instalação de interface. Você também pode excluir propriedades da classe de interface do dispositivo incluindo diretivas INF DelProperty em uma seção de instalação de interface. No entanto, você deve usar uma diretiva AddProperty ou DelProperty apenas para modificar as propriedades da classe de interface do dispositivo que são novas para o Windows Vista ou versões posteriores de sistemas operacionais Windows. Para propriedades da classe de interface do dispositivo que foram introduzidas no Windows Server 2003, Windows XP ou Windows 2000 e que têm entradas de valor de registro correspondentes, você deve continuar a usar diretivas AddReg inf e diretivas INF DelReg para definir e excluir as propriedades da classe de interface do dispositivo. Essas diretrizes se aplicam a propriedades definidas pelo sistema e propriedades personalizadas. Para obter mais informações sobre como usar a diretiva AddProperty e a diretiva DelProperty , consulte Using the INF AddProperty Directive and the INF DelProperty Directive.

Uma diretiva AddReg faz referência a uma ou mais seções do add-registry que definem informações específicas da interface do dispositivo no Registro durante a instalação dessa interface.

As informações do Registro sobre essa classe de interface devem incluir pelo menos um nome amigável para a nova classe de interface do dispositivo e quaisquer informações de que os componentes de nível mais alto precisem quando abrirem e usarem essa interface.

Além disso, essa seção install-interface-section pode usar qualquer uma das diretivas opcionais mostradas aqui para especificar operações de instalação específicas da interface.

Para obter mais informações sobre como usar as extensões .nt, .ntx86, .ntia64, .ntamd64, .ntarm, .ntarm64 definidas pelo sistema, consulte Criando arquivos INF para várias plataformas e sistemas operacionais.