SetupDiGetDriverInstallParamsA-Funktion (setupapi.h)

  • Artikel

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

Weitere Informationen

SetupDiSetDriverInstallParams