SetupDiSetSelectedDriverA-Funktion (setupapi.h)
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 |