SetupDiGetClassInstallParamsA-Funktion (setupapi.h)

  • Artikel

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

Weitere Informationen

SetupDiSetClassInstallParams