SetupDiGetClassInstallParamsA-Funktion (setupapi.h)
Die SetupDiGetClassInstallParams-Funktion ruft Klasseninstallationsparameter für einen Geräteinformationssatz oder ein bestimmtes Geräteinformationselement ab.
Syntax
WINSETUPAPI BOOL SetupDiGetClassInstallParamsA(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[out, optional] PSP_CLASSINSTALL_HEADER ClassInstallParams,
[in] DWORD ClassInstallParamsSize,
[out, optional] PDWORD RequiredSize
);
Parameter
[in] DeviceInfoSet
Ein Handle für einen Geräteinformationssatz , der die abzurufenden Klasseninstallationsparameter enthält.
[in, optional] DeviceInfoData
Ein Zeiger auf eine SP_DEVINFO_DATA Struktur, die ein Geräteinformationselement in DeviceInfoSet angegeben hat. Dieser Parameter ist optional und kann NULL sein. Wenn dieser Parameter angegeben ist, ruft SetupDiGetClassInstallParams die Klasseninstallationsparameter für das angegebene Gerät ab. Wenn dieser Parameter NULL ist, ruft SetupDiGetClassInstallParams die Klasseninstallationsparameter für die globale Klassentreiberliste ab, die DeviceInfoSet zugeordnet ist.
[out, optional] ClassInstallParams
Ein Zeiger auf einen Puffer, der eine SP_CLASSINSTALL_HEADER-Struktur enthält. Für diese Struktur muss der cbSize-Member bei der Eingabe auf sizeof(SP_CLASSINSTALL_HEADER) festgelegt sein, andernfalls wird der Puffer als ungültig betrachtet. Bei der Ausgabe wird der InstallFunction-Member mit dem Geräteinstallationsfunktionscode für die abgerufenen Klasseninstallationsparameter gefüllt. Wenn der Puffer groß genug ist, empfängt er auch die Für den Funktionscode spezifische Struktur der Klasseninstallationsparameter. Wenn ClassInstallParams nicht angegeben ist, muss ClassInstallParamsSize 0 sein.
[in] ClassInstallParamsSize
Die Größe des ClassInstallParams-Puffers in Bytes. Wenn der Puffer bereitgestellt wird, muss er mindestens so groß wie sizeof(SP_CLASSINSTALL_HEADER) sein. Wenn der Puffer nicht bereitgestellt wird, muss ClassInstallParamsSize 0 sein.
[out, optional] RequiredSize
Ein Zeiger auf eine Variable vom Typ DWORD, die die Anzahl von Bytes empfängt, die zum Speichern der Klasseninstallationsparameter erforderlich sind. Dieser Parameter ist optional und kann NULL sein.
Rückgabewert
Die Funktion gibt TRUE zurück, wenn sie erfolgreich ist. Andernfalls wird FALSE zurückgegeben, und der protokollierte Fehler kann mit einem Aufruf von GetLastError abgerufen werden.
Hinweise
Die Klasseninstallationsparameter sind spezifisch für einen bestimmten Geräteinstallationsfunktionscode , der im Feld ClassInstallHeader am Anfang des ClassInstallParams-Puffers gespeichert ist.
Hinweis
Der Setupapi.h-Header definiert SetupDiGetClassInstallParams 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 |
|---|---|
| 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 |