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-werden. 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 die cbSize Member auf Sizeof(SP_CLASSINSTALL_HEADER) festgelegt sein, für Eingaben oder der Puffer als ungültig angesehen wird. 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 Klasseninstallationsparameterstruktur, die speziell für den Funktionscode bestimmt ist. Wenn ClassInstallParams- nicht angegeben ist, muss ClassInstallParamsSize- 0 sein.
[in] ClassInstallParamsSize
Die Größe des ClassInstallParams- Puffers in Byte. Wenn der Puffer bereitgestellt wird, muss er mindestens so groß sein wie Sizeof(SP_CLASSINSTALL_HEADER). Wenn der Puffer nicht angegeben wird, muss ClassInstallParamsSize- 0sein.
[out, optional] RequiredSize
Ein Zeiger auf eine Variable vom Typ DWORD, die die Anzahl der Bytes empfängt, die zum Speichern der Klasseninstallationsparameter erforderlich sind. Dieser Parameter ist optional und kann NULL-werden.
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 GetLastErrorabgerufen werden.
Bemerkungen
Die Klasseninstallationsparameter sind spezifisch für einen bestimmten Geräteinstallationsfunktionscode, der im ClassInstallHeader Feld gespeichert ist, das sich am Anfang des ClassInstallParams Puffer befindet.
Anmerkung
Der header setupapi.h 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 |
|---|---|
| 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 |