Seção INF InterfaceInstall32

Esta secção cria uma ou mais novas classes de interface de dispositivo. Após a criação de uma nova classe, os dispositivos/drivers instalados podem registar suporte para a nova classe de interface do dispositivo chamando o 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 registar uma instância da classe interface, o driver de um dispositivo deve chamar o IoRegisterDeviceInterface com este GUID. O valor GUID especificado nesta secção pode também ser referenciado por uma diretiva INF AddInterface num INF DDInstall. Secção de interfaces.

Para mais informações sobre como criar um GUID, consulte Utilização de GUIDs em Drivers. Para a classe de interface definida pelo sistema GUIDS, veja os cabeçalhos apropriados, como Ks.h para as interfaces kernel-streaming.

secção-interfaz-instalação
Faz referência a uma secção definida pelo INF-writer, possivelmente com qualquer uma das extensões definidas pelo sistema, noutro local deste INF.

flags
Se especificado, esta entrada deve ser zero.

Remarks

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

Cada nome de secção da interface de instalação deve ser único dentro do ficheiro INF e deve seguir as regras gerais para definir nomes de secção. Para mais informações sobre estas regras, consulte Regras Gerais de Sintaxe para Ficheiros INF.

Qualquer secção de interface de instalação especificada tem a seguinte forma 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 mais informações sobre as entradas na secção interface-installation, consulte a Secção INF DDInstall.

A partir do Windows Vista, pode definir as propriedades da classe de interface do dispositivo incluindo diretivas INF AddProperty numa secção de instalação da interface. Também pode eliminar propriedades de classe de interface de dispositivo incluindo diretivas INF DelProperty numa secção de instalação de interface. No entanto, deve usar uma diretiva AddProperty ou DelProperty apenas para modificar propriedades da classe de interface do dispositivo que sejam novas no Windows Vista ou em versões posteriores dos sistemas operativos Windows. Para propriedades de classe de interface de dispositivo introduzidas no Windows Server 2003, Windows XP ou Windows 2000, e que têm entradas de valor de registo correspondentes, deve continuar a usar diretivas INF AddReg e INF DelReg para definir e eliminar as propriedades da classe interface de dispositivo. Estas diretrizes aplicam-se a propriedades definidas pelo sistema e propriedades personalizadas. Para mais informações sobre como usar as diretivas AddProperty e DelProperty , consulte Utilização da Diretiva INF AddProperty e da Diretiva INF DelProperty.

Uma diretiva AddReg refere-se a uma ou mais secções de adicionar registo que definem informação específica da interface do dispositivo no registo durante a instalação desta interface.

A informação do registo sobre esta classe de interface deve incluir pelo menos um nome amigável para a nova classe de interface do dispositivo e qualquer informação que os componentes de nível superior necessitem quando abrem e utilizam esta interface.

Além disso, tal secção de interface de instalação pode usar qualquer uma das diretivas opcionais aqui apresentadas para especificar operações de instalação específicas da interface.

Para mais informações sobre como usar as extensões .nt, .ntx86, .ntia64, .ntamd64, .ntarm, .ntarm64 , definidas pelo sistema, consulte Criação de Ficheiros INF para Múltiplas Plataformas e Sistemas Operativos.

Ver também

AddProperty

AddReg

BitReg

ClassInstall32

CopyFiles

DDInstall

DDInstall. Interfaces

DelFiles

DelProperty

DelReg

Ini2Reg

IoRegisterDeviceInterface

RenFiles

UpdateIniFields

UpdateInis