SetupDiGetDriverInfoDetailA-Funktion (setupapi.h)
Die SetupDiGetDriverInfoDetail-Funktion ruft Treiberinformationen für einen Geräteinformationssatz oder ein bestimmtes Geräteinformationselement im Geräteinformationssatz ab.
Syntax
WINSETUPAPI BOOL SetupDiGetDriverInfoDetailA(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[in] PSP_DRVINFO_DATA_A DriverInfoData,
[in, out] PSP_DRVINFO_DETAIL_DATA_A DriverInfoDetailData,
[in] DWORD DriverInfoDetailDataSize,
[out, optional] PDWORD RequiredSize
);
Parameter
[in] DeviceInfoSet
Ein Handle für einen Geräteinformationssatz , der 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 sein. 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 von 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 0 sein. Wenn dieser Parameter angegeben ist, DriverInfoDetailData.cbSize muss auf den Wert von sizeof(SP_DRVINFO_DETAIL_DATA) festgelegt werden, bevor SetupDiGetDriverInfoDetail aufgerufen wird.
[in] DriverInfoDetailDataSize
Die Größe des DriverInfoDetailData-Puffers in Bytes.
[out, optional] RequiredSize
Ein Zeiger auf eine Variable, die die Anzahl von 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 Liste der kompatiblen ID enthält. Die Listen haben REG_MULTI_SZ Format. Informationen zu Hardware und kompatiblen IDs finden Sie unter Geräteidentifikationszeichenfolgen.
Rückgabewert
Die Funktion gibt TRUE zurück, wenn sie erfolgreich ist. Andernfalls wird FALSE zurückgegeben, und der protokollierte Fehler kann durch einen Aufruf von GetLastError abgerufen werden.
Hinweise
Wenn der angegebene Treiberinformationsmember und der vom Aufrufer bereitgestellte Puffer gültig sind, wird diese Funktion garantiert, dass 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 ausgefüllt werden, während REG_MULTI_SZ Format beibehalten wird. In diesem Fall gibt die Funktion FALSE zurück, und ein Aufruf von GetLastError gibt ERROR_INSUFFICIENT_BUFFER zurück. Falls angegeben, enthält RequiredSize die Gesamtanzahl von Bytes, die für die Struktur mit allen IDs erforderlich sind.
Hinweis
Der setupapi.h-Header 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 nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
| Zielplattform | Desktop |
| Kopfzeile | setupapi.h (einschließlich Setupapi.h) |
| Bibliothek | Setupapi.lib |