SetupDiInstallDeviceInterfaces-Funktion (setupapi.h)

Artikel
03/01/2024

Die SetupDiInstallDeviceInterfaces-Funktion ist der Standardhandler für die DIF_INSTALLINTERFACES Installationsanforderung.

Syntax

WINSETUPAPI BOOL SetupDiInstallDeviceInterfaces(
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData
);

Parameter

[in] DeviceInfoSet

Ein Zeiger auf den Geräteinformationssatz , der ein Geräteinformationselement enthält, das das Gerät darstellt, für das Schnittstellen installiert werden sollen. Der Geräteinformationssatz darf nur Elemente für das lokale System enthalten.

[in] DeviceInfoData

Ein Zeiger auf eine SP_DEVINFO_DATA-Struktur , die das Geräteinformationselement in DeviceInfoSet angibt.

Rückgabewert

SetupDiInstallDeviceInterfaces gibt TRUE zurück, wenn die Funktion ohne Fehler abgeschlossen wurde. Wenn die Funktion mit einem Fehler abgeschlossen wurde, wird FALSE zurückgegeben, und der Fehlercode für den Fehler kann durch Aufrufen von GetLastError abgerufen werden.

Hinweise

SetupDiInstallDeviceInterfaces verarbeitet jeden AddInterface-Eintrag im DDInstall. Abschnitt "Schnittstellen " einer INF-Datei des Geräts und erstellt jede Schnittstelle durch Aufrufen von SetupDiCreateDeviceInterface.

Der Aufrufer von SetupDiInstallDeviceInterfaces muss Mitglied der Gruppe Administratoren sein.

Hinweis Nur ein Klasseninstallationsprogramm sollte SetupDiInstallDeviceInterfaces aufrufen und nur in situationen, in denen das Klasseninstallationsprogramm Installationsvorgänge für die Geräteschnittstelle ausführen muss, nachdem SetupDiInstallDeviceInterfaces den Standardinstallationsvorgang der Geräteschnittstelle abgeschlossen hat. In solchen Situationen muss das Klasseninstallationsprogramm SetupDiInstallDeviceInterfaces direkt aufrufen, wenn das Installationsprogramm eine DIF_INSTALLINTERFACES-Anforderung verarbeitet. Weitere Informationen zum Aufrufen des Standardhandlers finden Sie unter Aufrufen von DIF-Standardcodehandlern.

Informationen zum INF-Dateiformat finden Sie unter INF-Dateiabschnitte und -direktiven.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform	Desktop
Kopfzeile	setupapi.h (schließen Sie Setupapi.h ein)
Bibliothek	Setupapi.lib
DLL	Setupapi.dll

Weitere Informationen

DIF_INSTALLINTERFACES

SetupDiCreateDeviceInterface

Freigeben über