Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Cada um por Modelos ,DDInstall_. A secção de Interfaces pode ter uma ou mais diretivas AddInterface , dependendo de quantas interfaces de dispositivo um determinado dispositivo/driver suporta.
[install-section-name.Interfaces] |
[install-section-name.nt.Interfaces] |
[install-section-name.ntx86.Interfaces] |
[install-section-name.ntia64.Interfaces] | (Windows XP and later versions of Windows)
[install-section-name.ntamd64.Interfaces] | (Windows XP and later versions of Windows)
[install-section-name.ntarm.Interfaces] | (Windows 8 and later versions of Windows)
[install-section-name.ntarm64.Interfaces] (Windows 10 version 1709 and later versions of Windows)
AddInterface={InterfaceClassGUID} [, [reference string] [,[add-interface-section] [,flags]]] ...
[Include=filename.inf[,filename2.inf]...]
[Needs=inf-section-name[,inf-section-name]...]
Para suportar interfaces de dispositivo existentes, como qualquer uma das interfaces de kernel-streaming pré-definidas do sistema, especifique os valores InterfaceClassGUID apropriados nesta secção.
Para instalar um componente, como um driver de classe, que exporta uma nova classe de interfaces de dispositivo, um INF deve também ter uma secção INF InterfaceInstall32.
Para mais informações sobre interfaces de dispositivos, consulte Classes de Interface de Dispositivo.
Entradas
AddInterface={InterfaceClassGUID} [,[cadeia de referência] [,[add-interface-section] [,,flags_]]]...
Esta diretiva instala suporte para uma classe de interface de dispositivo, designada pelo valor especificado InterfaceClassGUID que o driver exporta para componentes de nível superior. Normalmente, também faz referência a uma secção de interface adicional definida pelo gravador INF noutra parte do ficheiro INF. Para informações detalhadas sobre como especificar esta diretiva, consulte a Diretiva INF AddInterface.
incluir=,nome do ficheiro. inf[,nome do ficheiro2. inf]...
Esta entrada opcional especifica um ou mais ficheiros INF adicionais fornecidos pelo sistema que contêm as secções necessárias para registar as classes de interface suportadas por este dispositivo/driver. Se esta entrada for especificada, normalmente também é uma entrada de Necessidades .
Necessidades=,inf-nome-seção[,inf-nome-seção]...
Esta entrada opcional especifica as secções específicas que devem ser processadas durante a instalação deste dispositivo. Normalmente, tal secção nomeada é uma .DDInstall_. Secção de Interfaces dentro de um ficheiro INF fornecido pelo sistema que está listado numa entrada Inclui . No entanto, pode ser qualquer secção que seja referenciada dentro de tal .DDInstall_. Secção de interfaces do INF incluído.
Remarks
O nome da secção DDInstall deve ser referenciado por uma entrada específica de dispositivo/modelos na secção Modelos por fabricante do ficheiro INF. Para informações sobre como usar as extensões definidas pelo sistema .nt, .ntx86, .ntia64, .ntamd64, .ntarm e .ntarm64 em ficheiros INF multiplataforma, consulte Criação de Ficheiros INF para Múltiplas Plataformas e Sistemas Operativos.
Se um {,InterfaceClassGUID_} especificado ainda não estiver instalado, o código de configuração do sistema operativo instala essa classe de interface de dispositivo no sistema. Se um ficheiro INF instalar uma ou mais novas classes de interface de dispositivo, pode também ter uma secção [InterfaceInstall32] a identificar o GUID da nova classe.
Para mais informações sobre como criar um GUID, consulte Utilização de GUIDs em Drivers. Para os GUIDs da classe de interface definidos pelo sistema, consulte o cabeçalho fornecido pelo sistema apropriado, como Ks.h para a classe de interface kernel-streaming GUIDS.
Quando um driver é carregado, deve chamar o IoRegisterDeviceInterface com o mesmo {,InterfaceClassGUID_} e string de referência usado numa diretiva AddInterface para obter o SymbolicLinkName completo para a interface do dispositivo. Deve fazer isto para cada interface de dispositivo na secção de DDInstall_. Interfaces que o driver suporta no dispositivo subjacente. Para cada NomeSymbolicLink, o driver deve chamar IoSetDeviceInterfaceState para ativar a interface do dispositivo. Normalmente, uma função PnP ou um controlador de filtro faz estas chamadas a partir da sua rotina AddDevice .
Examples
Este exemplo mostra a secção DDInstall. nt. Interfaces no ficheiro INF para o dispositivo/driver de áudio WDM fornecido pelo sistema.
;
; following AddInterface= are all single lines (without
; backslash line continuators) in the system-supplied INF file
;
[WDMPNPB003_Device.NT.Interfaces]
AddInterface=%KSCATEGORY_AUDIO%,%KSNAME_Wave%,\
WDM_SB16.Interface.Wave
AddInterface=%KSCATEGORY_AUDIO%,%KSNAME_Topology%,\
WDM_SB16.Interface.Topology
AddInterface=%KSCATEGORY_AUDIO%,%KSNAME_UART%,\
WDM_SB16.Interface.UART
AddInterface=%KSCATEGORY_AUDIO%,%KSNAME_FMSynth%,\
WDM_SB16.Interface.FMSynth
; ...
[Strings] ; only immediately preceding %strkey% tokens shown here
%KSCATEGORY_AUDIO% = "{6994ad04-93ef-11d0-a3cc-00a0c9223196}"
KSNAME_Wave = "Wave"
KSNAME_UART = "UART"
KSNAME_FMSynth = "FMSynth"
KSNAME_Topology = "Topology"
; ...