SetupDiEnumDeviceInfo-Funktion (setupapi.h)

Die SetupDiEnumDeviceInfo-Funktion gibt eine SP_DEVINFO_DATA-Struktur zurück, die ein Geräteinformationselement in einem Geräteinformationssatz angibt.

Syntax

WINSETUPAPI BOOL SetupDiEnumDeviceInfo(
  [in]  HDEVINFO         DeviceInfoSet,
  [in]  DWORD            MemberIndex,
  [out] PSP_DEVINFO_DATA DeviceInfoData
);

Parameter

[in] DeviceInfoSet

Ein Handle für den Geräteinformationssatz , für den eine SP_DEVINFO_DATA-Struktur zurückgegeben werden soll, die ein Geräteinformationselement darstellt.

[in] MemberIndex

Ein nullbasierter Index des abzurufenden Geräteinformationselements.

[out] DeviceInfoData

Ein Zeiger auf eine SP_DEVINFO_DATA-Struktur zum Empfangen von Informationen zu einem aufgezählten Geräteinformationselement. Der Aufrufer muss DeviceInfoData festlegen. cbSize in sizeof(SP_DEVINFO_DATA).

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

Wiederholte Aufrufe dieser Funktion geben ein Geräteinformationselement für ein anderes Gerät zurück. Diese Funktion kann wiederholt aufgerufen werden, um Informationen zu allen Geräten im Geräteinformationssatz abzurufen.

Um Geräteinformationselemente aufzulisten, sollte ein Installationsprogramm zunächst SetupDiEnumDeviceInfo aufrufen, wobei der MemberIndex-Parameter auf 0 festgelegt ist. Das Installationsprogramm sollte dann MemberIndex erhöhen und SetupDiEnumDeviceInfo aufrufen, bis keine weiteren Werte vorhanden sind (die Funktion schlägt fehl, und ein Aufruf von GetLastError gibt ERROR_NO_MORE_ITEMS zurück).

Rufen Sie SetupDiEnumDeviceInterfaces auf, um eine Kontextstruktur für ein Geräteschnittstellenelement (im Vergleich zu einem Geräteinformationselement ) abzurufen.

Anforderungen

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
DLL	Setupapi.dll
APIs	ext-ms-win-setupapi-classinstallers-l1-1-0 (eingeführt in Windows 8)

Weitere Informationen

SP_DEVINFO_DATA

SetupDiCreateDeviceInfo

SetupDiDeleteDeviceInfo

SetupDiEnumDeviceInterfaces

SetupDiOpenDeviceInfo