SetupDiGetSelectedDriverA-Funktion (setupapi.h)
Die SetupDiGetSelectedDriver--Funktion ruft den ausgewählten Treiber für einen Geräteinformationssatz oder ein bestimmtes Geräteinformationselement ab.
Syntax
WINSETUPAPI BOOL SetupDiGetSelectedDriverA(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[out] PSP_DRVINFO_DATA_A DriverInfoData
);
Parameter
[in] DeviceInfoSet
Ein Handle zum Geräteinformationssatz, für den ein ausgewählter Treiber abgerufen werden soll.
[in, optional] DeviceInfoData
Ein Zeiger auf eine SP_DEVINFO_DATA Struktur, die ein Geräteinformationselement angibt, das das Gerät in DeviceInfoSet- darstellt, für die der ausgewählte Treiber abgerufen werden soll. Dieser Parameter ist optional und kann NULL-werden. Wenn dieser Parameter angegeben ist, ruft SetupDiGetSelectedDriver den ausgewählten Treiber für das angegebene Gerät ab. Wenn dieser Parameter NULL-ist, ruft SetupDiGetSelectedDriver den ausgewählten Klassentreiber in der globalen Klassentreiberliste ab, die DeviceInfoSet-zugeordnet ist.
[out] DriverInfoData
Ein Zeiger auf eine SP_DRVINFO_DATA-Struktur, die Informationen über den ausgewählten Treiber empfängt.
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. Wenn für die angegebene Geräteinstanz kein Treiber ausgewählt wurde, wird der protokollierte Fehler ERROR_NO_DRIVER_SELECTED.
Bemerkungen
Anmerkung
Der header setupapi.h definiert SetupDiGetSelectedDriver 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 |