Verwenden von Geräteinstallationsfunktionen

In diesem Abschnitt werden die Geräteinstallationsfunktionen zusammengefasst. Mithilfe der Geräteinstallationsfunktionen kann die Installationssoftware die folgenden Arten von Vorgängen ausführen:

  • Installieren von Treibern

  • Behandeln von DIF-Codes.

  • Verwalten von Geräteinformationssätzen.

  • Verwalten von Treiberlisten.

  • Verwalten von Geräteschnittstellen.

  • Verwalten von Symbolen und anderen Bitmaps.

Die folgenden Tabellen enthalten Zusammenfassungen der folgenden Funktionstypen:

Treiberinstallationsfunktionen

Geräteinformationsfunktionen

Treiberinformationsfunktionen

Geräteinstallationshandler

Anpassungsfunktionen für die Geräteinstallation

Setupklassenfunktionen

Bitmap- und Symbolfunktionen

Geräteschnittstellenfunktionen

Geräteeigenschaftsfunktionen (Windows Vista und höher)

Registrierungsfunktionen

Andere Funktionen

Treiberinstallationsfunktionen

DiInstallDevice

Installiert ein angegebenes Treiberpaket, das im Treiberspeicher auf einem PnP-Gerät vorinstalliert ist, das im System vorhanden ist. (Windows Vista und neuere Versionen von Windows)

DiUninstallDevice

Deinstalliert ein Gerät und entfernt seinen Geräteknoten (devnode) aus dem System. (Windows 7 und neuere Versionen von Windows)

DiInstallDriver

Vorinstalliert ein Treiberpaket im Treiberspeicher und installiert dann das Treiberpaket auf entsprechenden PnP-Geräten, die im System vorhanden sind. (Windows Vista und neuere Versionen von Windows)

DiUninstallDriver

Entfernt ein Treiberpaket aus dem Treiber-Store. (Windows 10 Version 1703 und höher von Windows)

UpdateDriverForPlugAndPlayDevices

Aktualisiert das Treiberpaket, das für den Abgleich von PnP-Geräten installiert ist, die im System vorhanden sind.

DiRollbackDriver

Führt ein Rollback des Treiberpakets aus, das auf einem angegebenen Gerät installiert ist, auf das Sicherungstreiberpaket, das für das Gerät festgelegt ist. (Windows Vista und neuere Versionen von Windows)

Geräteinformationsfunktionen

Hinweis

SetupApi wird nicht in allen Editionen von Windows. Wenn möglich, sollten Sie APIs auf niedrigerer Ebene verwenden, z. B. apIs, die über CfgMgr32.dll. Tipps finden Sie unter Portieren von SetupApi zu CfgMgr32 .

SetupDiCreateDeviceInfoList

Erstellt einen leeren Geräteinformationssatz. Dieser Satz kann einer Klassen-GUID zugeordnet werden.

SetupDiCreateDeviceInfoListEx

Erstellt einen leeren Geräteinformationssatz. Dieser Satz kann einer Klassen-GUID zugeordnet werden und kann für Geräte auf einem Remotecomputer verwendet werden.

SetupDiCreateDeviceInfo

Erstellt ein neues Geräteinformationselement und fügt es dem angegebenen Geräteinformationssatz als neues Element hinzu.

SetupDiOpenDeviceInfo

Ruft Informationen zu einer vorhandenen Geräteinstanz ab und fügt sie dem angegebenen Geräteinformationssatz hinzu.

SetupDiEnumDeviceInfo

Gibt eine Kontextstruktur für ein Geräteinformationselement eines Geräteinformationssets zurück.

SetupDiGetDeviceInstanceId

Ruft die Geräteinstanz-ID ab, die einem Geräteinformationselement zugeordnet ist.

SetupDiGetDeviceInfoListClass

Ruft die Klassen-GUID ab, die einem Geräteinformationssatz zugeordnet ist, wenn ihm eine Klasse zugeordnet ist.

SetupDiGetDeviceInfoListDetail

Ruft Informationen ab, die einem Geräteinformationssatz zugeordnet sind, einschließlich der Klassen-GUID, des Remotecomputerhandpunkts und des Remotecomputernamens.

SetupDiGetClassDevPropertySheets

Ruft Handles für die Eigenschaftenblätter eines angegebenen Geräteinformationselements oder der Geräteeinrichtungsklasse eines angegebenen Geräteinformationssets ab.

SetupDiGetClassDevs

Gibt einen Geräteinformationssatz zurück, der alle Geräte einer angegebenen Klasse enthält.

SetupDiGetClassDevsEx

Gibt einen Geräteinformationssatz zurück, der alle Geräte einer angegebenen Klasse auf einem lokalen Oder Remotecomputer enthält.

SetupDiSetSelectedDevice

Legt das angegebene Geräteinformationselement als aktuell ausgewähltes Element eines Geräteinformationssets fest. Diese Funktion wird in der Regel von einem Installations-Assistenten verwendet.

SetupDiGetSelectedDevice

Ruft das aktuell ausgewählte Gerät für den angegebenen Geräteinformationssatz ab.

SetupDiRegisterDeviceInfo

Registriert eine neu erstellte Geräteinstanz beim Plug & Play Manager.

SetupDiDeleteDeviceInfo

Löscht einen Member aus dem angegebenen Geräteinformationssatz. Mit dieser Funktion wird das eigentliche Gerät nicht gelöscht.

SetupDiDestroyDeviceInfoList

Zerstört einen Geräteinformationssatz und gibt den zugehörigen Arbeitsspeicher frei.

Treiberinformationsfunktionen

SetupDiBuildDriverInfoList

Erstellt eine Liste der Treiber, die einer angegebenen Geräteinstanz oder der globalen Klassentreiberliste des Geräteinformationssets zugeordnet sind.

SetupDiEnumDriverInfo

Listet die Mitglieder einer Treiberinformationsliste auf.

SetupDiGetDriverInfoDetail

Ruft ausführliche Informationen für ein angegebenes Treiberinformationselement ab.

SetupDiSetSelectedDriver

Legt den angegebenen Member einer Treiberliste als derzeit ausgewählter Treiber fest. Sie kann auch verwendet werden, um die Treiberliste zurückzusetzen, sodass derzeit kein Treiber ausgewählt ist.

SetupDiGetSelectedDriver

Ruft das Mitglied einer Treiberliste ab, die als zu installierenden Treiber ausgewählt wurde.

SetupDiCancelDriverInfoSearch

Bricht eine Treiberlistensuche ab, die derzeit in einem anderen Thread ausgeführt wird.

SetupDiDestroyDriverInfoList

Zerstört eine Treiberinformationsliste.

Geräteinstallationshandler

SetupDiCallClassInstaller

Ruft das entsprechende Klasseninstallationsprogramm und alle registrierten Co-Installer mit der angegebenen Installationsanforderung auf.

SetupDiChangeState

Der Standardhandler für die DIF_PROPERTYCHANGE Anforderung. Sie kann verwendet werden, um den Zustand eines installierten Geräts zu ändern.

SetupDiRegisterCoDeviceInstallers

Registriert die gerätespezifischen Co-Installer, die in der INF-Datei für das angegebene Gerät aufgeführt sind. Diese Funktion ist der Standardhandler für DIF_REGISTER_COINSTALLERS.

SetupDiInstallDevice

Der Standardhandler für die DIF_INSTALLDEVICE Anforderung.

SetupDiInstallDriverFiles

Der Standardhandler für die DIF_INSTALLDEVICEFILES Anforderung.

SetupDiInstallDeviceInterfaces

Der Standardhandler für die DIF_INSTALLINTERFACES Anforderung. Es installiert die Schnittstellen, die in einem DDInstall aufgeführt sind. Schnittstellenabschnitt einer Geräte-INF-Datei.

SetupDiMoveDuplicateDevice

Diese Funktion ist veraltet und kann nicht in einer Version von Microsoft Windows.

SetupDiRemoveDevice

Der Standardhandler für die DIF_REMOVEDEVICE Anforderung.

SetupDiUnremoveDevice

Der Standardhandler für die DIF_UNREMOVE Anforderung.

SetupDiRegisterDeviceInfo

Der Standardhandler für die DIF_REGISTERDEVICE Anforderung.

SetupDiSelectDevice

Der Standardhandler für die DIF_SELECTDEVICE Anforderung.

SetupDiSelectBestCompatDrv

Der Standardhandler für die DIF_SELECTBESTCOMPATDRV Anforderung.

SetupDiSelectDevice

Standardhandler für die DIF_SELECTDEVICE Anforderung.

Anpassungsfunktionen für die Geräteinstallation

SetupDiGetClassInstallParams

Ruft Klassen-Installationsparameter für einen Geräteinformationssatz oder ein bestimmtes Geräteinformationselement ab.

SetupDiSetClassInstallParams

Legt Klassen-Installationsparameter für einen Geräteinformationssatz oder ein bestimmtes Geräteinformationselement fest oder bzw. legt diese fest.

SetupDiGetDeviceInstallParams

Ruft Geräte-Installationsparameter für einen Geräteinformationssatz oder ein bestimmtes Geräteinformationselement ab.

SetupDiSetDeviceInstallParams

Legt Geräte-Installationsparameter für einen Geräteinformationssatz oder ein bestimmtes Geräteinformationselement fest.

SetupDiGetDriverInstallParams

Ruft Installationsparameter für den angegebenen Treiber ab.

SetupDiSetDriverInstallParams

Legt die Installationsparameter für den angegebenen Treiber fest.

Setupklassenfunktionen

SetupDiBuildClassInfoList

Gibt eine Liste der Setupklassen-GUIDs zurück, die jede auf dem System installierte Klasse enthalten.

SetupDiBuildClassInfoListEx

Gibt eine Liste der Setupklassen-GUIDs zurück, die jede auf dem lokalen System oder einem Remotesystem installierte Klasse enthalten.

SetupDiGetClassDescription

Ruft die Klassenbeschreibung ab, die der angegebenen GUID der Setupklasse zugeordnet ist.

SetupDiGetClassDescriptionEx

Ruft die Beschreibung einer Setupklasse ab, die auf einem lokalen Oder Remotecomputer installiert ist.

SetupDiGetINFClass

Ruft die Klasse einer angegebenen Geräte-INF-Datei ab.

SetupDiClassGuidsFromName

Ruft die GUIDs ab, die dem angegebenen Klassennamen zugeordnet sind. Diese Liste basiert darauf, welche Klassen derzeit auf dem System installiert sind.

SetupDiClassGuidsFromNameEx

Ruft die GUIDs ab, die dem angegebenen Klassennamen zugeordnet sind. Diese resultierende Liste enthält die Klassen, die derzeit auf einem lokalen oder Remotecomputer installiert sind.

SetupDiClassNameFromGuid

Ruft den Klassennamen ab, der der Klassen-GUID zugeordnet ist.

SetupDiClassNameFromGuidEx

Ruft den Klassennamen ab, der einer Klassen-GUID zugeordnet ist. Die -Klasse kann auf einem lokalen oder Remotecomputer installiert werden.

SetupDiInstallClass

Installiert den Abschnitt ClassInstall32 der angegebenen INF-Datei.

SetupDiInstallClassEx

Installiert ein Klasseninstallationsprogramm oder eine Schnittstellenklasse.

SetupDiOpenClassRegKey

Öffnet den Registrierungsschlüssel der Geräteeinrichtungsklasse oder einen bestimmten Unterschlüssel der -Klasse.

SetupDiOpenClassRegKeyEx

Öffnet den Registrierungsschlüssel der Geräteeinrichtungsklasse, den Registrierungsschlüssel der Geräteschnittstellenklasse oder einen bestimmten Unterschlüssel der Klasse. Diese Funktion öffnet den angegebenen Schlüssel auf dem lokalen Computer oder auf einem Remotecomputer.

Bitmap- und Symbolfunktionen

SetupDiGetClassImageList

Erstellt eine Bildliste, die Bitmaps für jede installierte Klasse enthält und die Liste in einer Datenstruktur zurückgibt.

SetupDiGetClassImageListEx

Erstellt eine Bildliste von Bitmaps für jede Klasse, die auf einem lokalen oder Remotecomputer installiert ist.

SetupDiGetClassImageIndex

Ruft den Index innerhalb der Klassenbildliste einer angegebenen Klasse ab.

SetupDiGetClassBitmapIndex

Ruft den Index des Minisymbols ab, das für die angegebene Klasse angegeben wurde.

SetupDiDrawMiniIcon

Zeichnet das angegebene Minisymbol an der angeforderten Position.

SetupDiLoadClassIcon

Lädt sowohl das große als auch das Minisymbol für die angegebene Klasse.

SetupDiLoadDeviceIcon

Lädt ein Gerätesymbol für ein angegebenes Gerät. (Windows Vista und neuere Versionen von Windows)

SetupDiDestroyClassImageList

Zerstört eine Klassenbildliste.

Geräteschnittstellenfunktionen

Hinweis

SetupApi wird nicht in allen Editionen von Windows. Wenn möglich, sollten Sie APIs auf niedrigerer Ebene verwenden, z. B. apIs, die über CfgMgr32.dll. Tipps finden Sie unter Portieren von SetupApi zu CfgMgr32 .

SetupDiCreateDeviceInterface

Registriert die Gerätefunktionalität (eine Geräteschnittstelle) für ein Gerät.

SetupDiOpenDeviceInterface

Ruft Informationen zu einer vorhandenen Geräteschnittstelle ab und fügt sie dem angegebenen Geräteinformationssatz hinzu.

SetupDiGetDeviceInterfaceAlias

Gibt einen Alias der angegebenen Geräteschnittstelle zurück.

SetupDiGetClassDevs

Gibt einen Geräteinformationssatz zurück, der alle Geräte einer angegebenen Klasse enthält.

SetupDiGetClassDevsEx

Gibt einen Geräteinformationssatz zurück, der alle Geräte einer angegebenen Klasse auf einem lokalen oder Remotecomputer enthält.

SetupDiEnumDeviceInterfaces

Gibt eine Kontextstruktur für ein Geräteschnittstellenelement eines Geräteinformationssatzes zurück. Jeder Aufruf gibt Informationen zu einer Geräteschnittstelle zurück.

Die Funktion kann wiederholt aufgerufen werden, um Informationen zu mehreren Schnittstellen abzurufen, die von einem oder mehreren Geräten verfügbar gemacht werden.

SetupDiGetDeviceInterfaceDetail

Gibt Details zu einer bestimmten Geräteschnittstelle zurück.

SetupDiCreateDeviceInterfaceRegKey

Erstellt einen Registrierungsunterschlüssel zum Speichern von Informationen zu einer Geräteschnittstelleninstanz und gibt ein Handle für den Schlüssel zurück.

SetupDiOpenDeviceInterfaceRegKey

Öffnet den Registrierungsunterschlüssel, der von Anwendungen und Treibern zum Speichern von Informationen verwendet wird, die für eine Geräteschnittstelleninstanz spezifisch sind, und gibt ein Handle für den Schlüssel zurück.

SetupDiDeleteDeviceInterfaceRegKey

Löscht den Registrierungsunterschlüssel, der von Anwendungen und Treibern zum Speichern von Informationen verwendet wurde, die für eine Geräteschnittstelleninstanz spezifisch sind.

SetupDiInstallDeviceInterfaces

Der Standardhandler für die DIF_INSTALLINTERFACES Anforderung. Es installiert die Schnittstellen, die in einer DDInstall-Datei aufgeführt sind. Schnittstellenabschnitt einer Geräte-INF-Datei.

SetupDiRemoveDeviceInterface

Entfernt eine registrierte Geräteschnittstelle aus dem System.

SetupDiDeleteDeviceInterfaceData

Löscht eine Geräteschnittstelle aus einem Geräteinformationssatz.

SetupDiSetDeviceInterfaceDefault

Legt eine angegebene Geräteschnittstelle als Standardschnittstelle für eine Geräteklasse fest.

SetupDiInstallClassEx

Installiert ein Klasseninstallationsprogramm oder eine Schnittstellenklasse.

SetupDiOpenClassRegKeyEx

Öffnet den Registrierungsschlüssel der Geräteeinrichtungsklasse , den Registrierungsschlüssel der Geräteschnittstellenklasse oder einen bestimmten Unterschlüssel der Klasse. Diese Funktion öffnet den angegebenen Schlüssel auf dem lokalen Computer oder auf einem Remotecomputer.

Geräteeigenschaftenfunktionen (Windows Vista und höher)

Hinweis

SetupApi wird nicht in allen Editionen von Windows unterstützt. Wenn möglich, sollten Sie APIs auf niedrigerer Ebene verwenden, z. B. apis, die über CfgMgr32.dllverfügbar sind. Tipps finden Sie unter Portieren von SetupApi zu CfgMgr32 .

SetupDiGetClassProperty

Ruft eine Geräteeigenschaft ab, die für eine Geräteeinrichtungsklasse oder eine Geräteschnittstellenklasse festgelegt ist.

SetupDiGetClassPropertyEx

Ruft eine Klasseneigenschaft für eine Geräteeinrichtungsklasse oder eine Geräteschnittstellenklasse auf einem lokalen oder Remotecomputer ab.

SetupDiGetClassPropertyKeys

Ruft ein Array der Geräteeigenschaftsschlüssel ab, die die Geräteeigenschaften darstellen, die für eine Geräteeinrichtungsklasse oder eine Geräteschnittstellenklasse festgelegt sind.

SetupDiGetClassPropertyKeysEx

Ruft ein Array der Geräteeigenschaftsschlüssel ab, die die Geräteeigenschaften darstellen, die für eine Geräteeinrichtungsklasse oder eine Geräteschnittstellenklasse auf einem lokalen oder Remotecomputer festgelegt sind.

SetupDiGetDeviceInterfaceProperty

Ruft eine Geräteeigenschaft ab, die für eine Geräteschnittstelle festgelegt ist.

SetupDiGetDeviceInterfacePropertyKeys

Ruft ein Array von Geräteeigenschaftsschlüsseln ab, die die Geräteeigenschaften darstellen, die für eine Geräteschnittstelle festgelegt sind.

SetupDiGetDeviceProperty

Ruft eine Geräteinstanzeigenschaft ab.

SetupDiGetDevicePropertyKeys

Ruft ein Array der Geräteeigenschaftsschlüssel ab, die die Geräteeigenschaften darstellen, die für eine Geräteinstanz festgelegt sind.

SetupDiSetClassProperty

Legt eine Klasseneigenschaft für eine Geräteeinrichtungsklasse oder eine Geräteschnittstellenklasse fest.

SetupDiSetClassPropertyEx

Legt eine Geräteeigenschaft für eine Geräteeinrichtungsklasse oder eine Geräteschnittstellenklasse auf einem lokalen oder Remotecomputer fest.

SetupDiSetDeviceInterfaceProperty

Legt eine Geräteeigenschaft einer Geräteschnittstelle fest.

SetupDiSetDeviceProperty

Legt eine Geräteinstanzeigenschaft fest.

Registrierungsfunktionen

Hinweis

SetupApi wird nicht in allen Editionen von Windows unterstützt. Wenn möglich, sollten Sie APIs auf niedrigerer Ebene verwenden, z. B. apis, die über CfgMgr32.dllverfügbar sind. Tipps finden Sie unter Portieren von SetupApi zu CfgMgr32 .

SetupDiCreateDevRegKey

Erstellt einen Registrierungsspeicherschlüssel für gerätespezifische Konfigurationsinformationen und gibt ein Handle für den Schlüssel zurück.

SetupDiOpenDevRegKey

Öffnet einen Registrierungsspeicherschlüssel für gerätespezifische Konfigurationsinformationen und gibt ein Handle für den Schlüssel zurück.

SetupDiDeleteDevRegKey

Löscht die angegebenen benutzerzugehörigen Registrierungsschlüssel, die einem Geräteinformationselement zugeordnet sind.

SetupDiOpenClassRegKey

Öffnet den Registrierungsschlüssel der Setupklasse oder einen bestimmten Unterschlüssel der Klasse.

SetupDiOpenClassRegKeyEx

Öffnet den Registrierungsschlüssel der Geräteeinrichtungsklasse, den Registrierungsschlüssel der Geräteschnittstellenklasse oder einen bestimmten Unterschlüssel der Klasse.

Diese Funktion öffnet den angegebenen Schlüssel auf dem lokalen Computer oder auf einem Remotecomputer.

SetupDiCreateDeviceInterfaceRegKey

Erstellt einen nicht flüchtigen Registrierungsunterschlüssel zum Speichern von Informationen zu einer Geräteschnittstelleninstanz und gibt ein Handle für den Schlüssel zurück.

SetupDiOpenDeviceInterfaceRegKey

Öffnet den Registrierungsunterschlüssel, der von Anwendungen und Treibern zum Speichern von Informationen verwendet wird, die für eine Geräteschnittstelleninstanz spezifisch sind, und gibt ein Handle für den Schlüssel zurück.

SetupDiDeleteDeviceInterfaceRegKey

Löscht den Registrierungsunterschlüssel, der von Anwendungen und Treibern zum Speichern von Informationen verwendet wurde, die für eine Geräteschnittstelleninstanz spezifisch sind.

SetupDiSetDeviceRegistryProperty

Legt die angegebene Plug & Play Geräteeigenschaft fest.

SetupDiGetDeviceRegistryProperty

Ruft die angegebene Plug & Play Geräteeigenschaft ab.

SetupDiGetClassRegistryProperty

Ruft eine angegebene Geräteklasseneigenschaft aus der Registrierung ab.

SetupDiSetClassRegistryProperty

Legt eine angegebene Geräteklasseneigenschaft in der Registrierung fest.

Andere Funktionen

SetupDiGetActualModelsSection

Ruft den entsprechenden ergänzten Abschnitt INF-Modelle ab, der beim Installieren eines Geräts aus einer GERÄTE-INF-Datei verwendet werden soll.

SetupDiGetActualSectionToInstall

Ruft den entsprechenden DDInstall-Abschnitt ab, der beim Installieren eines Geräts aus einer Geräte-INF-Datei verwendet werden soll.

SetupDiGetActualSectionToInstallEx

Ruft den Namen des Abschnitts INF DDInstall ab, der ein Gerät für ein angegebenes Betriebssystem und eine prozessororientierte Architektur installiert.

SetupDiGetHwProfileFriendlyName

Ruft den einer Hardwareprofil-ID zugeordneten Angezeigtennamen ab.

SetupDiGetHwProfileFriendlyNameEx

Ruft den Einer Hardwareprofil-ID zugeordneten Angezeigtennamen auf einem lokalen Computer oder Remotecomputer ab.

SetupDiGetHwProfileList

Ruft eine Liste aller derzeit definierten Hardwareprofil-IDs ab.

SetupDiGetHwProfileListEx

Ruft eine Liste aller derzeit definierten Hardwareprofil-IDs auf einem lokalen Oder Remotecomputer ab.

SetupDiRestartDevices

Startet ein angegebenes Gerät neu oder startet bei Bedarf alle Geräte, die von derselben Funktion betrieben werden, und filtert Treiber wie das angegebene Gerät.