Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Elk per model, DDInstall_. De sectie Interfaces kan een of meer AddInterface-instructies hebben, afhankelijk van het aantal apparaatinterfaces dat door een bepaald apparaat/stuurprogramma wordt ondersteund.
[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]...]
Als u bestaande apparaatinterfaces wilt ondersteunen, zoals een van de vooraf gedefinieerde kernelstreaminginterfaces van het systeem, geeft u de juiste InterfaceClassGUID-waarden in deze sectie op.
Als u een onderdeel, zoals een klassestuurprogramma, wilt installeren dat een nieuwe klasse apparaatinterfaces exporteert, moet een INF ook een INF InterfaceInstall32-sectie hebben.
Zie Apparaatinterfaceklassen voor meer informatie over apparaatinterfaces.
Invoer
AddInterface={InterfaceClassGUID} [,[verwijzingstekenreeks] [,[add-interface-section] [,,flags_]]]...
Deze richtlijn installeert ondersteuning voor een apparaatinterfaceklasse, aangewezen door de opgegeven InterfaceClassGUID-waarde die het stuurprogramma exporteert naar onderdelen op een hoger niveau. Meestal verwijst het ook naar een inF-writer-gedefinieerde add-interface-section elders in het INF-bestand. Zie de INF AddInterface-richtlijn voor gedetailleerde informatie over het opgeven van deze richtlijn.
Include=,bestandsnaam. inf[, bestandsnaam2.inf]...
Met deze optionele vermelding geeft u een of meer extra door het systeem geleverde INF-bestanden op die secties bevatten die nodig zijn om de interfaceklassen te registreren die door dit apparaat/stuurprogramma worden ondersteund. Als deze vermelding is opgegeven, is dit meestal een vermelding Vereist .
Needs=,inf-section-name[,inf-section-name]...
Met deze optionele vermelding geeft u de specifieke secties op die moeten worden verwerkt tijdens de installatie van dit apparaat. Normaal gesproken is een dergelijke benoemde sectie een ,DDInstall_. Sectie Interfaces in een door het systeem geleverd INF-bestand dat wordt vermeld in een vermelding Opnemen . Het kan echter elke sectie zijn waarnaar wordt verwezen binnen een dergelijke ,DDInstall_. De sectie Interfaces van de opgenomen INF.
Remarks
Er moet worden verwezen naar de naam van de DDInstall-sectie door een apparaat-/modelspecifieke vermelding onder de sectie Modellen per fabrikant van het INF-bestand. Zie INF-bestanden voor meerdere platforms en besturingssystemen maken voor meer informatie over het gebruik van de door het systeem gedefinieerde .nt, .ntarm, .ntarm4- en.ntarm64-extensies in platformoverschrijdende INF-bestanden.
Als een opgegeven {,InterfaceClassGUID_} nog niet is geïnstalleerd, installeert de installatiecode van het besturingssysteem die apparaatinterfaceklasse in het systeem. Als een INF-bestand een of meer nieuwe apparaatinterfaceklassen installeert, kan het ook een sectie [InterfaceInstall32] hebben waarmee de GUID voor de nieuwe klasse wordt geïdentificeerd.
Zie GuiD's gebruiken in stuurprogramma's voor meer informatie over het maken van een GUID. Zie voor de door het systeem gedefinieerde interfaceklasse-GUID's de juiste door het systeem geleverde header, zoals Ks.h voor de GUIDS van de kernelstreaming-interfaceklasse.
Wanneer een stuurprogramma wordt geladen, moet het IoRegisterDeviceInterface aanroepen met dezelfde {,InterfaceClassGUID_} en verwijzingsreeks die in een AddInterface-instructie wordt gebruikt om de volledige SymbolLinkName voor de apparaatinterface op te halen. Dit moet worden gebruikt voor elke apparaatinterface in de INF-DDInstall_. De sectie Interfaces die het stuurprogramma ondersteunt op het onderliggende apparaat. Voor elke SymbolLinkName moet het stuurprogramma IoSetDeviceInterfaceState aanroepen om de apparaatinterface in te schakelen. Meestal maakt een PnP-functie of filterstuurprogramma deze aanroepen vanuit de AddDevice-routine .
Examples
In dit voorbeeld ziet u de DDInstall. nt. De sectie Interfaces in het INF-bestand voor het door het systeem geleverde WDM-audioapparaat/-stuurprogramma.
;
; 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"
; ...