SetupDiSetDriverInstallParamsA-Funktion (setupapi.h)

Artikel
11/20/2024

Die SetupDiSetDriverInstallParams-Funktion legt Treiberinstallationsparameter für ein Treiberinformationselement fest.

Syntax

WINSETUPAPI BOOL SetupDiSetDriverInstallParamsA(
  [in]           HDEVINFO              DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA      DeviceInfoData,
  [in]           PSP_DRVINFO_DATA_A    DriverInfoData,
  [in]           PSP_DRVINSTALL_PARAMS DriverInstallParams
);

Parameter

[in] DeviceInfoSet

Ein Handle zu einem Geräteinformationssatz, das ein Treiberinformationselement enthält, das den Treiber darstellt, für den Installationsparameter festgelegt werden sollen.

[in, optional] DeviceInfoData

Ein Zeiger auf eine SP_DEVINFO_DATA Struktur, die ein Geräteinformationselement in DeviceInfoSet-angibt. Dieser Parameter ist optional und kann auf NULL-festgelegt werden. Wenn dieser Parameter angegeben ist, legt SetupDiSetDriverInstallParams die Treiberinstallationsparameter für das angegebene Gerät fest. Wenn dieser Parameter NULL-ist, legt SetupDiSetDriverInstallParams Treiberinstallationsparameter für DeviceInfoSetfest.

[in] DriverInfoData

Ein Zeiger auf eine SP_DRVINFO_DATA-Struktur, die den Treiber angibt, für den Installationsparameter festgelegt werden. Wenn DeviceInfoData- angegeben ist, muss dieser Treiber mitglied einer Treiberliste sein, die DeviceInfoData-zugeordnet ist. Wenn DeviceInfoData-NULL-ist, muss dieser Treiber mitglied der globalen Klassentreiberliste für DeviceInfoSet-sein.

[in] DriverInstallParams

Ein Zeiger auf eine SP_DRVINSTALL_PARAMS Struktur, die die neuen Treiberinstallationsparameter angibt.

Rückgabewert

Die Funktion gibt TRUE- zurück, wenn sie erfolgreich ist. Andernfalls wird FALSE- zurückgegeben, und der protokollierte Fehler kann durch einen Aufruf von GetLastErrorabgerufen werden.

Bemerkungen

Anmerkung

Der header setupapi.h definiert SetupDiSetDriverInstallParams als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform-	Desktop
Header-	setupapi.h (include Setupapi.h)
Library	Setupapi.lib

Siehe auch

SetupDiGetDriverInstallParams

Freigeben über