Sectie INF InterfaceInstall32

In deze sectie worden een of meer nieuwe apparaatinterfaceklassen gemaakt. Nadat een nieuwe klasse is gemaakt, kunnen vervolgens geïnstalleerde apparaten/stuurprogramma's ondersteuning registreren voor de nieuwe apparaatinterfaceklasse door IoRegisterDeviceInterface aan te roepen.

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

Invoer

InterfaceClassGUID
Hiermee geeft u een GUID-waarde op die de zojuist geëxporteerde apparaatinterfaceklasse identificeert.

Als u een exemplaar van de interfaceklasse wilt registreren, moet het stuurprogramma van een apparaat IoRegisterDeviceInterface aanroepen met deze GUID. De opgegeven GUID-waarde in deze sectie kan ook worden verwezen door een INF AddInterface-instructie in een INF DDInstall. Sectie Interfaces.

Zie GuiD's gebruiken in stuurprogramma's voor meer informatie over het maken van een GUID. Zie voor de door het systeem gedefinieerde interfaceklasse-GUIDS de juiste headers, zoals Ks.h voor de kernelstreaminginterfaces.

install-interface-section
Verwijst naar een inF-schrijver gedefinieerde sectie, mogelijk met een van de door het systeem gedefinieerde extensies, elders in deze INF.

flags
Indien opgegeven, moet deze vermelding nul zijn.

Remarks

Wanneer een opgegeven InterfaceClassGUID nog niet is geïnstalleerd in het systeem, wordt die interfaceklasse geïnstalleerd als de bijbehorende DDInstall. De sectie Interfaces wordt verwerkt tijdens de installatie van het apparaat of wanneer het stuurprogramma van dat apparaat de eerste aanroep naar IoRegisterDeviceInterface uitvoert.

Elke installatie-interface-sectienaam moet uniek zijn binnen het INF-bestand en moet voldoen aan de algemene regels voor het definiëren van sectienamen. Zie Algemene syntaxisregels voor INF-bestanden voor meer informatie over deze regels.

Elke opgegeven installatie-interfacesectie heeft de volgende algemene vorm:

[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]...]
...

Zie de sectie INF DDInstall voor meer informatie over de vermeldingen in de sectie interface-install-.

Vanaf Windows Vista kunt u eigenschappen van apparaatinterfaceklassen instellen door INF AddProperty-instructies op te nemen in een sectie interface-installatie. U kunt ook eigenschappen van apparaatinterfaceklassen verwijderen door INF DelProperty-instructies op te geven in een sectie interface-installatie. U moet echter alleen een AddProperty- of DelProperty-instructie gebruiken om eigenschappen van apparaatinterfaceklassen te wijzigen die nieuw zijn voor Windows Vista of latere versies van Windows besturingssystemen. Voor eigenschappen van apparaatinterfaceklassen die zijn geïntroduceerd op Windows Server 2003, Windows XP of Windows 2000 en die overeenkomende registerwaardevermeldingen hebben, moet u DE INF AddReg-instructies en INF DelReg-instructies blijven gebruiken om de eigenschappen van de apparaatinterfaceklasse in te stellen en te verwijderen. Deze richtlijnen zijn van toepassing op door het systeem gedefinieerde eigenschappen en aangepaste eigenschappen. Zie De INF AddProperty-richtlijn en de INF DelProperty-richtlijn gebruiken voor meer informatie over het gebruik van de Richtlijn AddProperty en de INF DelProperty-richtlijn.

Een AddReg-instructie verwijst naar een of meer secties voor het toevoegen van register die apparaat-interfacespecifieke informatie in het register instellen tijdens de installatie van deze interface.

De registerinformatie over deze interfaceklasse moet ten minste een beschrijvende naam bevatten voor de nieuwe apparaatinterfaceklasse en alle informatie die de onderdelen op een hoger niveau nodig hebben wanneer ze deze interface openen en gebruiken.

Bovendien kan een dergelijke installatie-interface-sectie een van de optionele instructies gebruiken die hier worden weergegeven om interfacespecifieke installatiebewerkingen op te geven.

Zie INF-bestanden maken voor meerdere platforms en besturingssystemen voor meer informatie over het gebruik van door het systeem gedefinieerde .nt, .ntnt, .ntarm64, .ntarm64.

Zie ook

AddProperty

AddReg

BitReg

ClassInstall32

CopyFiles

DDInstall

DDInstall. Interfaces

DelFiles

DelProperty

DelReg

Ini2Reg

IoRegisterDeviceInterface

RenFiles

UpdateIniFields

UpdateInis