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.

HinweisDriverInfoDetailData.cbSize darf nicht auf den Wert des Parameters DriverInfoDetailDataSize festgelegt werden.

 

[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

Weitere Informationen

SetupDiEnumDriverInfo

SetupDiGetSelectedDriver