Apparaatinstallatiefuncties gebruiken

In deze sectie vindt u een overzicht van de installatiefuncties van het apparaat. Met behulp van de installatiefuncties van het apparaat kan de installatiesoftware de volgende typen bewerkingen uitvoeren:

• Stuurprogramma's installeren

• DIF-codes verwerken.

• Apparaatgegevenssets beheren.

• Stuurprogrammalijsten beheren.

• Apparaatinterfaces beheren.

• Pictogrammen en andere bitmaps beheren.

De volgende tabellen bevatten samenvattingen van de volgende typen functies:

Installatiefuncties van stuurprogramma's

Functies voor apparaatinformatie

Informatiefuncties voor bestuurders

Handlers voor apparaatinstallatie

Aanpassingsfuncties voor apparaatinstallatie

Klassefuncties instellen

Bitmap- en pictogramfuncties

Apparaatinterfacefuncties

Functies voor apparaateigenschappen (Windows Vista en hoger)

registerfuncties

Andere functies

Installatiefuncties van stuurprogramma's

DiInstallDevice-	Installeert een opgegeven stuurprogrammapakket dat vooraf is geïnstalleerd in het stuurprogrammaarchief op een PnP-apparaat dat aanwezig is in het systeem. (Windows Vista en latere versies van Windows)
DiUninstallDevice-	Hiermee verwijdert u een apparaat en verwijdert u het apparaatknooppunt (devnode) van het systeem. (Windows 7 en nieuwere versies van Windows)
DiInstallDriver-	Installeert een stuurprogrammapakket vooraf in het stuurprogrammaarchief en installeert vervolgens het stuurprogrammapakket op overeenkomende PnP-apparaten die aanwezig zijn in het systeem. (Windows Vista en latere versies van Windows)
DiUninstallDriver	Hiermee verwijdert u een stuurprogrammapakket uit de Driver Store. (Windows 10 versie 1703 en nieuwere versies van Windows)
UpdateDriverForPlugAndPlayDevices	Werkt het stuurprogrammapakket bij dat is geïnstalleerd voor overeenkomende PnP-apparaten die aanwezig zijn in het systeem.
DiRollbackDriver-	Hiermee wordt het stuurprogrammapakket dat op een opgegeven apparaat is geïnstalleerd, teruggedraaid naar het back-upstuurprogrammapakket dat voor het apparaat is ingesteld. (Windows Vista en latere versies van Windows)

Functies voor apparaatinformatie

Opmerking

SetupApi wordt niet ondersteund in alle edities van Windows. Indien mogelijk moet u API's van lagere lagen gebruiken, zoals api's die beschikbaar zijn via CfgMgr32.dll. Zie Porting van SetupApi naar CfgMgr32 voor tips.

SetupDiCreateDeviceInfoList	Hiermee maakt u een lege set apparaatgegevens. Deze set kan worden gekoppeld aan een klasse-GUID.
SetupDiCreateDeviceInfoListEx	Hiermee maakt u een lege set apparaatgegevens. Deze set kan worden gekoppeld aan een klasse-GUID en kan worden gebruikt voor apparaten op een externe computer.
SetupDiCreateDeviceInfo	Hiermee maakt u een nieuw element voor apparaatgegevens en voegt u dit toe als een nieuw lid aan de opgegeven apparaatgegevensset.
SetupDiOpenDeviceInfo	Haalt informatie over een bestaand apparaatexemplaren op en voegt deze toe aan de opgegeven apparaatgegevensset.
SetupDiEnumDeviceInfo	Retourneert een contextstructuur voor een apparaatinformatie-element van een apparaatgegevensset.
SetupDiGetDeviceInstanceId	Hiermee haalt u de apparaatexemplaar-id op die is gekoppeld aan een apparaatinformatie-element.
SetupDiGetDeviceInfoListClass	Haalt de klasse-GUID op die is gekoppeld aan een apparaatgegevensset als deze een gekoppelde klasse heeft.
SetupDiGetDeviceInfoListDetail	Haalt informatie op die is gekoppeld aan een apparaatgegevensset, inclusief de klasse-GUID, de ingang van de externe computer en de naam van de externe computer.
SetupDiGetClassDevPropertySheets	Verkrijgt handvatten naar de eigenschappenbladen van een bepaald apparaatinformatie-element of van de apparaatinstallatieklasse van een bepaalde set apparaatgegevens.
SetupDiGetClassDevs	Hiermee wordt een apparaatgegevensset geretourneerd die alle apparaten van een opgegeven klasse bevat.
SetupDiGetClassDevsEx	Hiermee wordt een apparaatgegevensset geretourneerd die alle apparaten van een opgegeven klasse op een lokale of externe computer bevat.
SetupDiSetSelectedDevice	Hiermee stelt u het opgegeven apparaatinformatie-element in als het geselecteerde lid van een apparaatgegevensset. Deze functie wordt doorgaans gebruikt door een installatiewizard.
SetupDiGetSelectedDevice	Hiermee wordt het momenteel geselecteerde apparaat opgehaald voor de opgegeven apparaatinformatieset.
SetupDiRegisterDeviceInfo	Registreert een nieuw apparaatexemplaar bij de Plug and Play-manager.
SetupDiDeleteDeviceInfo	Hiermee verwijdert u een lid uit de opgegeven apparaatgegevensset. Met deze functie wordt het werkelijke apparaat niet verwijderd.
SetupDiDestroyDeviceInfoList	Hiermee vernietigt u een apparaatgegevensset en maakt u alle bijbehorende geheugen vrij.

Informatiefuncties voor bestuurders

SetupDiBuildDriverInfoList	Hiermee maakt u een lijst met stuurprogramma's die zijn gekoppeld aan een opgegeven apparaatexemplaar of met de algemene lijst met stuurprogramma's van de apparaatgegevensset.
SetupDiEnumDriverInfo	Somt de elementen op van een lijst met bestuurderinformatie.
SetupDiGetDriverInfoDetail	Hiermee haalt u gedetailleerde informatie op voor een opgegeven driverinformatie-element.
SetupDiSetSelectedDriver	Hiermee stelt u het opgegeven lid van een stuurprogrammalijst in als het huidig geselecteerde stuurprogramma. Het kan ook worden gebruikt om de lijst met stuurprogramma's opnieuw in te stellen, zodat er geen momenteel geselecteerd stuurprogramma is.
SetupDiGetSelectedDriver	Hiermee wordt het lid opgehaald van een stuurprogrammalijst die is geselecteerd als het stuurprogramma dat moet worden geïnstalleerd.
SetupDiCancelDriverInfoSearch-	Hiermee annuleert u een zoekopdracht in een lijst met stuurprogramma's die momenteel in een andere thread wordt uitgevoerd.
SetupDiDestroyDriverInfoList	Hiermee wordt een lijst met stuurprogramma-informatie vernietigd.

Handlers voor apparaatinstallatie

SetupDiCallClassInstaller	Roept het juiste klasse-installatieprogramma en alle geregistreerde co-installatieprogramma's aan met de opgegeven installatieaanvraag.
SetupDiChangeState	De standaardhandler voor de DIF_PROPERTYCHANGE-aanvraag. Deze kan worden gebruikt om de status van een geïnstalleerd apparaat te wijzigen.
SetupDiRegisterCoDeviceInstallers	Registreert de apparaatspecifieke co-installatieprogramma's die worden vermeld in het INF-bestand voor het opgegeven apparaat. Deze functie is de standaardhandler voor DIF_REGISTER_COINSTALLERS.
SetupDiInstallDevice	De standaardhandler voor de DIF_INSTALLDEVICE aanvraag.
SetupDiInstallDriverFiles	De standaardhandler voor de DIF_INSTALLDEVICEFILES aanvraag.
SetupDiInstallDeviceInterfaces	De standaardhandler voor de DIF_INSTALLINTERFACES aanvraag. Hiermee worden de interfaces geïnstalleerd die worden vermeld in een DDInstall.Interfaces sectie van een INF-bestand van een apparaat.
SetupDiMoveDuplicateDevice	Deze functie is verouderd en kan niet worden gebruikt in een versie van Microsoft Windows.
SetupDiRemoveDevice	De standaardhandler voor de DIF_REMOVEDEVICE aanvraag.
SetupDiUnremoveDevice	De standaardhandler voor de DIF_UNREMOVE-aanvraag.
SetupDiRegisterDeviceInfo	De standaardhandler voor de DIF_REGISTERDEVICE aanvraag.
SetupDiSelectDevice	De standaardhandler voor de DIF_SELECTDEVICE aanvraag.
SetupDiSelectBestCompatDrv	De standaardhandler voor de DIF_SELECTBESTCOMPATDRV aanvraag.
SetupDiSelectDevice	Standaardhandler voor de DIF_SELECTDEVICE aanvraag.

Aanpassingsfuncties voor apparaatinstallatie

SetupDiGetClassInstallParams	Hiermee haalt u parameters voor de installatie van een klasse op voor een apparaatgegevensset of een bepaald apparaatinformatie-element.
SetupDiSetClassInstallParams	Hiermee stelt u de installatieparameters van een klasse in of wist u deze voor een apparaatgegevensset of een bepaald apparaatinformatie-element.
SetupDiGetDeviceInstallParams	Hiermee haalt u parameters voor apparaatinstallatie op voor een apparaatgegevensset of een bepaald apparaatinformatie-element.
SetupDiSetDeviceInstallParams	Hiermee stelt u parameters voor apparaatinstallatie in voor een apparaatgegevensset of een bepaald apparaatinformatie-element.
SetupDiGetDriverInstallParams	Hiermee worden installatieparameters opgehaald voor het opgegeven stuurprogramma.
SetupDiSetDriverInstallParams	Hiermee stelt u de installatieparameters voor het opgegeven stuurprogramma in.

Klassefuncties configureren

SetupDiBuildClassInfoList	Retourneert een lijst met installatieklasse-GUID's die elke klasse bevat die op het systeem is geïnstalleerd.
SetupDiBuildClassInfoListEx	Retourneert een lijst met installatieklasse-GUID's die elke klasse bevat die op het lokale systeem of een extern systeem is geïnstalleerd.
SetupDiGetClassDescription	Haalt de klassebeschrijving op die is gekoppeld aan de opgegeven setupklasse-GUID.
SetupDiGetClassDescriptionEx	Hiermee wordt de beschrijving opgehaald van een installatieklasse die is geïnstalleerd op een lokale of externe computer.
SetupDiGetINFClass	Haalt de klasse van een opgegeven INF-apparaatbestand op.
SetupDiClassGuidsFromName	Haalt de GUID's op die zijn gekoppeld aan de opgegeven klassenaam. Deze lijst is gebaseerd op de klassen die momenteel op het systeem zijn geïnstalleerd.
SetupDiClassGuidsFromNameEx	Haalt de GUID's op die zijn gekoppeld aan de opgegeven klassenaam. Deze resulterende lijst bevat de klassen die momenteel zijn geïnstalleerd op een lokale of externe computer.
SetupDiClassNameFromGuid	Haalt de klassenaam op die is gekoppeld aan de klasse-GUID.
SetupDiClassNameFromGuidEx	Haalt de klassenaam op die is gekoppeld aan een klasse-GUID. De klasse kan worden geïnstalleerd op een lokale of externe computer.
SetupDiInstallClass	Installeert de sectie ClassInstall32 van het opgegeven INF-bestand.
SetupDiInstallClassEx	Hiermee installeert u een klasse-installatieprogramma of een interfaceklasse.
SetupDiOpenClassRegKey	Hiermee opent u de registersleutel van de apparaatinstallatieklasse of een specifieke subsleutel van de klasse.
SetupDiOpenClassRegKeyEx	Hiermee opent u de registersleutel van de apparaatinstallatieklasse, de registersleutel van de apparaatinterface of een specifieke subsleutel van de klasse. Met deze functie opent u de opgegeven sleutel op de lokale computer of op een externe computer.

Bitmap- en pictogramfuncties

SetupDiGetClassImageList	Hiermee wordt een afbeeldingenlijst opgebouwd die bitmaps bevat voor elke geïnstalleerde class en geeft de lijst terug in een gegevensstructuur.
SetupDiGetClassImageListEx	Maakt een afbeeldingslijst van bitmaps voor elke class die op een lokale of externe computer is geïnstalleerd.
SetupDiGetClassImageIndex	Haalt de index op in de klasse afbeeldingslijst van een opgegeven klasse.
SetupDiGetClassBitmapIndex	Haalt de index op van het minipictogram dat is opgegeven voor de opgegeven klasse.
SetupDiDrawMiniIcon	Hiermee tekent u het opgegeven minipictogram op de aangevraagde locatie.
SetupDiLoadClassIcon	Laadt zowel het grote als het minipictogram voor de opgegeven klasse.
SetupDiLoadDeviceIcon	Laadt een apparaatpictogram voor een opgegeven apparaat. (Windows Vista en latere versies van Windows)
SetupDiDestroyClassImageList	Hiermee wordt een lijst met klassenafbeeldingen vernietigd.

Apparaatinterface functies

Opmerking

SetupApi wordt niet ondersteund in alle edities van Windows. Indien mogelijk moet u API's van lagere lagen gebruiken, zoals api's die beschikbaar zijn via CfgMgr32.dll. Zie Porting van SetupApi naar CfgMgr32 voor tips.

SetupDiCreateDeviceInterface	Registreert apparaatfunctionaliteit (een apparaatinterface) voor een apparaat.
SetupDiOpenDeviceInterface	Haalt informatie over een bestaande apparaatinterface op en voegt deze toe aan de opgegeven apparaatgegevensset.
SetupDiGetDeviceInterfaceAlias	Retourneert een alias van de opgegeven apparaatinterface.
SetupDiGetClassDevs	Hiermee wordt een apparaatgegevensset geretourneerd die alle apparaten van een opgegeven klasse bevat.
SetupDiGetClassDevsEx	Hiermee wordt een apparaatgegevensset geretourneerd die alle apparaten van een opgegeven klasse op een lokale of externe computer bevat.
SetupDiEnumDeviceInterfaces	Retourneert een contextstructuur voor een apparaatinterface-element van een apparaatgegevensset. Elke aanroep retourneert informatie over één apparaatinterface. De functie kan herhaaldelijk worden aangeroepen om informatie te verkrijgen over verschillende interfaces die door een of meer apparaten worden weergegeven.
SetupDiGetDeviceInterfaceDetail	Retourneert details over een bepaalde apparaatinterface.
SetupDiCreateDeviceInterfaceRegKey	Hiermee maakt u een registersubsleutel aan voor het opslaan van informatie over een exemplaar van de apparaatinterface en retourneert een handle naar de sleutel.
SetupDiOpenDeviceInterfaceRegKey	Hiermee opent u de registersubsleutel die wordt gebruikt door toepassingen en stuurprogramma's om informatie op te slaan die specifiek is voor een instantie van de apparaatinterface en geeft een handle naar de sleutel terug.
SetupDiDeleteDeviceInterfaceRegKey	Hiermee verwijdert u de registersubsleutel die door toepassingen en stuurprogramma's is gebruikt om informatie op te slaan die specifiek is voor een exemplaar van de apparaatinterface.
SetupDiInstallDeviceInterfaces	Is de standaardhandler voor de DIF_INSTALLINTERFACES aanvraag. Hiermee worden de interfaces geïnstalleerd die worden vermeld in een DDInstall.Interfaces-sectie van een apparaatbestands-INF.
SetupDiRemoveDeviceInterface	Hiermee verwijdert u een geregistreerde apparaatinterface uit het systeem.
SetupDiDeleteDeviceInterfaceData	Hiermee verwijdert u een apparaatinterface uit een apparaatgegevensset.
SetupDiSetDeviceInterfaceDefault	Hiermee stelt u een opgegeven apparaatinterface in als de standaardinterface voor een apparaatklasse.
SetupDiInstallClassEx	Hiermee installeert u een klasse-installatieprogramma of een interfaceklasse.
SetupDiOpenClassRegKeyEx	Hiermee opent u de registersleutel van de apparaatinstallatieklasse , de registersleutel van de apparaatinterface of een specifieke subsleutel van de klasse. Met deze functie opent u de opgegeven sleutel op de lokale computer of op een externe computer.

Functies voor apparaateigenschappen (Windows Vista en hoger)

Opmerking

SetupApi wordt niet ondersteund in alle edities van Windows. Indien mogelijk moet u API's van lagere lagen gebruiken, zoals api's die beschikbaar zijn via CfgMgr32.dll. Zie Porting van SetupApi naar CfgMgr32 voor tips.

SetupDiGetClassProperty	Hiermee haalt u een apparaateigenschap op die is ingesteld voor een apparaatinstallatieklasse of een apparaatinterfaceklasse.
SetupDiGetClassPropertyEx	Haalt een klasse-eigenschap op voor een apparaatinstallatieklasse of een apparaatinterfaceklasse op een lokale of externe computer.
SetupDiGetClassPropertyKeys	Hiermee haalt u een matrix op van de apparaateigenschapssleutels die de apparaateigenschappen vertegenwoordigen die zijn ingesteld voor een apparaatinstallatieklasse of een apparaatinterfaceklasse.
SetupDiGetClassPropertyKeysEx	Hiermee haalt u een matrix op van de apparaateigenschapssleutels die de apparaateigenschappen vertegenwoordigen die zijn ingesteld voor een apparaatinstallatieklasse of een apparaatinterfaceklasse op een lokale of externe computer.
SetupDiGetDeviceInterfaceProperty	Hiermee haalt u een apparaateigenschap op die is ingesteld voor een apparaatinterface.
SetupDiGetDeviceInterfacePropertyKeys	Hiermee haalt u een matrix van apparaateigenschapssleutels op die de apparaateigenschappen vertegenwoordigen die zijn ingesteld voor een apparaatinterface.
SetupDiGetDeviceProperty	Haalt een apparaateigenschap op.
SetupDiGetDevicePropertyKeys	Haal een reeks apparaateigenschapssleutels op die de apparaateigenschappen vertegenwoordigen die zijn ingesteld voor een apparaat exemplaar.
SetupDiSetClassProperty	Hiermee stelt u een klasse-eigenschap in voor een apparaatinstallatieklasse of een apparaatinterfaceklasse.
SetupDiSetClassPropertyEx	Hiermee stelt u een apparaateigenschap in voor een apparaatinstallatieklasse of een apparaatinterfaceklasse op een lokale of externe computer.
SetupDiSetDeviceInterfaceProperty	Hiermee stelt u een apparaateigenschap van een apparaatinterface in.
SetupDiSetDeviceProperty	Hiermee stelt u een eigenschap van een apparaatexemplaren in.

Registerfuncties

Opmerking

SetupApi wordt niet ondersteund in alle edities van Windows. Indien mogelijk moet u API's van lagere lagen gebruiken, zoals api's die beschikbaar zijn via CfgMgr32.dll. Zie Porting van SetupApi naar CfgMgr32 voor tips.

SetupDiCreateDevRegKey	Hiermee maakt u een registeropslagsleutel voor apparaatspecifieke configuratiegegevens en retourneert u een ingang naar de sleutel.
SetupDiOpenDevRegKey	Hiermee opent u een registeropslagsleutel voor apparaatspecifieke configuratiegegevens en retourneert u een ingang naar de sleutel.
SetupDiDeleteDevRegKey	Hiermee verwijdert u de opgegeven registersleutels die toegankelijk zijn voor de gebruiker die zijn gekoppeld aan een apparaatinformatie-element.
SetupDiOpenClassRegKey	Hiermee opent u de registersleutel van de installatieklasse of een specifieke subsleutel van de klasse.
SetupDiOpenClassRegKeyEx	Hiermee opent u de registersleutel van de apparaatinstallatieklasse, de registersleutel van de apparaatinterface of een specifieke subsleutel van de klasse. Met deze functie opent u de opgegeven sleutel op de lokale computer of op een externe computer.
SetupDiCreateDeviceInterfaceRegKey	Maakt een niet-vluchtige registersubsleutel aan voor het opslaan van informatie over een apparaatinterface-exemplaar en retourneert een handle naar de sleutel.
SetupDiOpenDeviceInterfaceRegKey	Hiermee opent u de registersubsleutel die wordt gebruikt door toepassingen en stuurprogramma's om informatie op te slaan die specifiek is voor een exemplaar van de apparaatinterface en een ingang naar de sleutel retourneert.
SetupDiDeleteDeviceInterfaceRegKey	Hiermee verwijdert u de registersubsleutel die door toepassingen en stuurprogramma's is gebruikt om informatie op te slaan die specifiek is voor een exemplaar van de apparaatinterface.
SetupDiSetDeviceRegistryProperty	Hiermee stelt u de opgegeven plug- en play-apparaateigenschap in.
SetupDiGetDeviceRegistryProperty	Hiermee haalt u de opgegeven Plug en Play-apparaateigenschap op.
SetupDiGetClassRegistryProperty	Hiermee haalt u een opgegeven eigenschap van de apparaatklasse op uit het register.
SetupDiSetClassRegistryProperty	Hiermee stelt u een opgegeven eigenschap van de apparaatklasse in het register in.

Andere functies

SetupDiGetActualModelsSection	Hiermee haalt u de juiste aangepaste INF-modellensectie op die moet worden gebruikt bij het installeren van een apparaat vanuit een apparaat-INF-bestand.
SetupDiGetActualSectionToInstall	Haalt de juiste DDInstall-sectie op die moet worden gebruikt bij het installeren van een apparaat vanuit een INF-apparaatbestand.
SetupDiGetActualSectionToInstallEx-	Haalt de naam op van de sectie INF DDInstall waarmee een apparaat wordt geïnstalleerd voor een opgegeven besturingssysteem en processorarchitectuur.
SetupDiGetHwProfileFriendlyName	Haalt de vriendelijke naam op die is gekoppeld aan een hardwareprofiel-ID.
SetupDiGetHwProfileFriendlyNameEx	Haalt de vriendelijke naam op die is gekoppeld aan een hardwareprofiel-ID op een lokale of externe computer.
SetupDiGetHwProfileList	Hiermee wordt een lijst opgehaald met alle momenteel gedefinieerde hardwareprofiel-id's.
SetupDiGetHwProfileListEx	Hiermee haalt u een lijst op van alle momenteel gedefinieerde hardwareprofiel-id's op een lokale of externe computer.
SetupDiRestartDevices	Start een opgegeven apparaat opnieuw op of start, indien nodig, alle apparaten die worden beheerd door dezelfde functie en filterstuurprogramma's als het opgegeven apparaat.