SetupDiGetDriverInstallParamsA-Funktion (setupapi.h)
Die SetupDiGetDriverInstallParams-Funktion ruft Treiberinstallationsparameter für einen Geräteinformationssatz oder ein bestimmtes Geräteinformationselement ab.
Syntax
WINSETUPAPI BOOL SetupDiGetDriverInstallParamsA(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[in] PSP_DRVINFO_DATA_A DriverInfoData,
[out] PSP_DRVINSTALL_PARAMS DriverInstallParams
);
Parameter
[in] DeviceInfoSet
Ein Handle für einen Geräteinformationssatz , der 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 sein. 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 DeviceInfoSet ist.
[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 ein Mitglied der Treiberliste für das Gerät sein, das von 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 empfangen.
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 GetLastError abgerufen werden.
Hinweise
Hinweis
Der setupapi.h-Header definiert SetupDiGetDriverInstallParams als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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 |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
| Zielplattform | Desktop |
| Kopfzeile | setupapi.h (einschließlich Setupapi.h) |
| Bibliothek | Setupapi.lib |