SetupDiGetDriverInstallParamsW-Funktion (setupapi.h)
Die SetupDiGetDriverInstallParams Funktion ruft Treiberinstallationsparameter für einen Geräteinformationssatz oder ein bestimmtes Geräteinformationselement ab.
Syntax
WINSETUPAPI BOOL SetupDiGetDriverInstallParamsW(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[in] PSP_DRVINFO_DATA_W DriverInfoData,
[out] 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 abgerufen werden sollen.
[in, optional] DeviceInfoData
Ein Zeiger auf eine SP_DEVINFO_DATA Struktur, die ein Geräteinformationselement enthält, das das Gerät darstellt, für das Installationsparameter abgerufen werden sollen. Dieser Parameter ist optional und kann NULL-werden. Wenn dieser Parameter angegeben ist, ruft SetupDiGetDriverInstallParams Informationen zu einem Treiber ab, der Mitglied einer Treiberliste für das angegebene Gerät ist. Wenn dieser Parameter NULL-ist, ruft SetupDiGetDriverInstallParams Informationen zu einem Treiber ab, der Mitglied der globalen Klassentreiberliste für DeviceInfoSetist.
[in] DriverInfoData
Ein Zeiger auf eine SP_DRVINFO_DATA-Struktur, die das Treiberinformationselement angibt, das den Treiber darstellt, für den Installationsparameter abgerufen werden sollen. Wenn DeviceInfoData- angegeben wird, muss der Treiber mitglied der Treiberliste für das Gerät sein, das durch DeviceInfoData-angegeben wird. Andernfalls muss der Treiber Mitglied der globalen Klassentreiberliste für DeviceInfoSet-sein.
[out] DriverInstallParams
Ein Zeiger auf eine SP_DRVINSTALL_PARAMS Struktur, um die Installationsparameter für diesen Treiber zu erhalten.
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 SetupDiGetDriverInstallParams 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 |