SetupDiSetSelectedDriverA-Funktion (setupapi.h)

  • Artikel

Die SetupDiSetSelectedDriver-Funktion legt den ausgewählten Treiber für ein Geräteinformationselement oder den ausgewählten Klassentreiber für einen Geräteinformationssatz fest oder setzt diesen zurück.

Syntax

WINSETUPAPI BOOL SetupDiSetSelectedDriverA(
  [in]      HDEVINFO           DeviceInfoSet,
  [in, out] PSP_DEVINFO_DATA   DeviceInfoData,
  [in, out] PSP_DRVINFO_DATA_A DriverInfoData
);

Parameter

[in] DeviceInfoSet

Ein Handle für den Geräteinformationssatz , der die Treiberliste enthält, aus der ein Treiber für ein Geräteinformationselement oder für den Geräteinformationssatz ausgewählt werden soll.

[in, out] DeviceInfoData

Ein Zeiger auf eine SP_DEVINFO_DATA-Struktur , die das Geräteinformationselement in DeviceInfoSet angibt. Dieser Parameter ist optional und kann NULL sein. Wenn dieser Parameter angegeben ist, legt SetupDiSetSelectedDriver den ausgewählten Treiber für das angegebene Gerät fest oder setzt diesen zurück. Wenn dieser Parameter NULL ist, legt SetupDiSetSelectedDriver den ausgewählten Klassentreiber für DeviceInfoSet fest oder setzt diesen zurück.

[in, out] DriverInfoData

Ein Zeiger auf eine SP_DRVINFO_DATA-Struktur , die den auszuwählenden Treiber angibt. Dieser Parameter ist optional und kann NULL sein. Wenn dieser Parameter und DeviceInfoData angegeben werden, muss der angegebene Treiber Mitglied einer Treiberliste sein, die DeviceInfoData zugeordnet ist. Wenn dieser Parameter angegeben ist und DeviceInfoDataNULL ist, muss der Treiber Mitglied der globalen Klassentreiberliste für DeviceInfoSet sein. Wenn dieser Parameter NULL ist, wird der ausgewählte Treiber für das Geräteinformationselement zurückgesetzt, wenn DeviceInfoData angegeben ist, oder der Geräteinformationssatz, wenn DeviceInfoDataNULL ist.

If the DriverInfoData.Reserviert ist NULL. Der Aufrufer fordert eine Suche nach einem Treiberknoten mit den angegebenen Parametern (DriverType, Description und ProviderName) an. Wenn eine Übereinstimmung gefunden wird, wird dieser Treiberknoten ausgewählt. Das Feld Reserviert wird bei der Ausgabe aktualisiert, um den tatsächlichen Treiberknoten widerzuspiegeln, auf dem die Übereinstimmung gefunden wurde. Wenn keine Übereinstimmung gefunden wird, schlägt die Funktion fehl, und ein Aufruf von GetLastError gibt ERROR_INVALID_PARAMETER zurück.

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

Wenn der Aufrufer von SetupDiSetSelectedDriver Mitglied der Gruppe Administratoren ist, wird die Klasse des Geräts auf die Klasse des ausgewählten Treibers festgelegt, sofern die beiden Klassen unterschiedlich sind.

Wenn DriverInfoDataNULL ist, setzt SetupDiSetSelectedDriver den ausgewählten Treiber zurück. Daher gibt es keinen ausgewählten Treiber.

Hinweis

Der Setupapi.h-Header definiert SetupDiSetSelectedDriver 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

SetupDiGetSelectedDriver