SetupDiGetDeviceInstallParamsW-Funktion (setupapi.h)
Die SetupDiGetDeviceInstallParams Funktion ruft Geräteinstallationsparameter für einen Geräteinformationssatz oder ein bestimmtes Geräteinformationselement ab.
Syntax
WINSETUPAPI BOOL SetupDiGetDeviceInstallParamsW(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[out] PSP_DEVINSTALL_PARAMS_W DeviceInstallParams
);
Parameter
[in] DeviceInfoSet
Ein Handle für den Geräteinformationssatz, der die abzurufenden Geräteinstallationsparameter enthält.
[in, optional] DeviceInfoData
Ein Zeiger auf eine SP_DEVINFO_DATA Struktur, die das Geräteinformationselement in DeviceInfoSet-angibt. Dieser Parameter ist optional und kann NULL-werden. Wenn dieser Parameter angegeben ist, ruft SetupDiGetDeviceInstallParams die Installationsparameter für das angegebene Gerät ab. Wenn dieser Parameter NULL-ist, ruft die Funktion die globalen Geräteinstallationsparameter ab, die DeviceInfoSet-zugeordnet sind.
[out] DeviceInstallParams
Ein Zeiger auf eine SP_DEVINSTALL_PARAMS Struktur, die die Geräteinstallationsparameter empfängt. DeviceInstallParams.cbSize- muss vor dem Aufrufen dieser Funktion auf die Größe der Struktur in Bytes festgelegt werden.
Rückgabewert
Die Funktion gibt TRUE- zurück, wenn sie erfolgreich ist. Andernfalls wird FALSE- zurückgegeben, und der protokollierte Fehler kann abgerufen werden, indem ein Aufruf an GetLastError-ausgeführt wird.
Bemerkungen
Anmerkung
Der Header "setupapi.h" definiert SetupDiGetDeviceInstallParams 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 |
| API-Satz | ext-ms-win-setupapi-classinstallers-l1-1-0 (eingeführt in Windows 8) |