SetupDiSetSelectedDriverA-Funktion (setupapi.h)
Der SetupDiSetSelectedDriver Funktionssätze oder Setzt den ausgewählten Treiber für ein Geräteinformationselement oder den ausgewählten Klassentreiber für einen Geräteinformationssatz 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-werden. Wenn dieser Parameter angegeben ist, SetupDiSetSelectedDriver legt oder setzt den ausgewählten Treiber für das angegebene Gerät zurück. Wenn dieser Parameter NULL-, SetupDiSetSelectedDriver- festgelegt oder zurückgesetzt wird, wird der ausgewählte Klassentreiber für DeviceInfoSet.
[in, out] DriverInfoData
Ein Zeiger auf eine SP_DRVINFO_DATA Struktur, die den auszuwählenden Treiber angibt. Dieser Parameter ist optional und kann NULL-werden. 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 DeviceInfoData-NULL-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 festgelegt ist, wenn DeviceInfoData-NULL-ist.
Wenn der DriverInfoData.Reservierte ist NULL-, fordert der Aufrufer eine Suche nach einem Treiberknoten mit den angegebenen Parametern an (DriverType, Descriptionund ProviderName). Wenn eine Übereinstimmung gefunden wird, wird dieser Treiberknoten ausgewählt. Das Feld Reservierte wird für die 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 GetLastErrorabgerufen werden.
Bemerkungen
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 DriverInfoData-NULL-ist, setzt SetupDiSetSelectedDriver den ausgewählten Treiber zurück. Daher ist kein ausgewählter Treiber vorhanden.
Anmerkung
Der header setupapi.h 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 |
|---|---|
| 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 |