SetupDiGetDriverInfoDetailW-Funktion (setupapi.h)
Die SetupDiGetDriverInfoDetail-funktion ruft Treiberinformationendetails für einen Geräteinformationssatz oder ein bestimmtes Geräteinformationselement im Geräteinformationssatz ab.
Syntax
WINSETUPAPI BOOL SetupDiGetDriverInfoDetailW(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[in] PSP_DRVINFO_DATA_W DriverInfoData,
[in, out] PSP_DRVINFO_DETAIL_DATA_W DriverInfoDetailData,
[in] DWORD DriverInfoDetailDataSize,
[out, optional] PDWORD RequiredSize
);
Parameter
[in] DeviceInfoSet
Ein Handle zu einem Geräteinformationssatz, das ein Treiberinformationselement enthält, für das Treiberinformationen abgerufen werden sollen.
[in, optional] DeviceInfoData
Ein Zeiger auf eine SP_DEVINFO_DATA Struktur, die ein Geräteinformationselement angibt, das das Gerät darstellt, für das Treiberinformationen abgerufen werden sollen. Dieser Parameter ist optional und kann NULL-werden. Wenn dieser Parameter angegeben ist, ruft SetupDiGetDriverInfoDetail Informationen zu einem Treiber in einer Treiberliste für das angegebene Gerät ab. Wenn dieser Parameter NULL-ist, ruft SetupDiGetDriverInfoDetail 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 Details abgerufen werden sollen. Wenn DeviceInfoData- angegeben ist, muss der Treiber ein Mitglied der Treiberliste für das Gerät sein, das durch DeviceInfoData-angegeben wird. Andernfalls muss der Treiber Mitglied der globalen Klassentreiberliste für DeviceInfoSet-sein.
[in, out] DriverInfoDetailData
Ein Zeiger auf eine SP_DRVINFO_DETAIL_DATA Struktur, die detaillierte Informationen zum angegebenen Treiber empfängt. Wenn dieser Parameter nicht angegeben ist, muss DriverInfoDetailDataSize null sein. Wenn dieser Parameter angegeben ist, DriverInfoDetailData.cbSize- muss auf den Wert sizeof(SP_DRVINFO_DETAIL_DATA) festgelegt werden, bevor SetupDiGetDriverInfoDetailaufgerufen wird.
[in] DriverInfoDetailDataSize
Die Größe des DriverInfoDetailData- Puffers in Byte.
[out, optional] RequiredSize
Ein Zeiger auf eine Variable, die die Anzahl der Bytes empfängt, die zum Speichern der detaillierten Treiberinformationen erforderlich sind. Dieser Wert enthält sowohl die Größe der Struktur als auch die zusätzlichen Bytes, die für den Zeichenpuffer mit variabler Länge am Ende erforderlich sind, der die Hardware-ID-Liste und die kompatible ID-Liste enthält. Die Listen befinden sich im REG_MULTI_SZ Format. Informationen zu Hardware- und kompatiblen IDs finden Sie unter Device Identification Strings.
Rückgabewert
Die Funktion gibt TRUE- zurück, wenn sie erfolgreich ist. Andernfalls wird FALSE- zurückgegeben, und der protokollierte Fehler kann abgerufen werden, indem ein Aufruf an GetLastError-ausgeführt wird.
Bemerkungen
Wenn das angegebene Treiberinformationselement und der vom Aufrufer bereitgestellte Puffer beide gültig sind, wird diese Funktion garantiert alle statischen Felder in der SP_DRVINFO_DETAIL_DATA Struktur und so viele IDs wie möglich im Puffer mit variabler Länge am Ende ausfüllen und gleichzeitig REG_MULTI_SZ Format beibehalten. In diesem Fall gibt die Funktion FALSE- zurück, und ein Aufruf von GetLastError gibt ERROR_INSUFFICIENT_BUFFER zurück. Wenn angegeben, enthält RequiredSize die Gesamtanzahl der Bytes, die für die Struktur mit allen IDs erforderlich sind.
Anmerkung
Der header setupapi.h definiert SetupDiGetDriverInfoDetail 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 |