Функция SetupDiEnumDeviceInfo (setupapi.h)

Функция SetupDiEnumDeviceInfo возвращает структуру SP_DEVINFO_DATA , которая задает элемент сведений об устройстве в наборе сведений об устройстве.

Синтаксис

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

Параметры

[in] DeviceInfoSet

Дескриптор набора сведений об устройстве , для которого возвращается SP_DEVINFO_DATA структура , представляющая элемент сведений об устройстве.

[in] MemberIndex

Отсчитываемый от нуля индекс элемента сведений об устройстве.

[out] DeviceInfoData

Указатель на структуру SP_DEVINFO_DATA для получения сведений о перечисленном элементе сведений об устройстве. Вызывающий объект должен задать DeviceInfoData. cbSize to sizeof(SP_DEVINFO_DATA).

Возвращаемое значение

Функция возвращает значение TRUE , если оно выполнено успешно. В противном случае возвращает значение FALSE , а ошибка, зарегистрированная в журнале, может быть получена с помощью вызова GetLastError.

Замечания

Повторяющиеся вызовы этой функции возвращают элемент сведений об устройстве для другого устройства. Эту функцию можно вызывать многократно, чтобы получить сведения обо всех устройствах в наборе сведений об устройстве.

Чтобы перечислить элементы сведений об устройстве, установщик должен изначально вызвать SetupDiEnumDeviceInfo с параметром MemberIndex значение 0. Затем установщик должен увеличить memberIndex и вызвать SetupDiEnumDeviceInfo , пока не будет больше значений (функция завершается сбоем и вызов GetLastError возвращает ERROR_NO_MORE_ITEMS).

Вызовите SetupDiEnumDeviceInterfaces , чтобы получить структуру контекста для элемента интерфейса устройства (и элемента сведений об устройстве).

Пример использования SetupDiEnumDeviceInfo доступен на странице документирования SetupDiGetClassDevsW.

Требования

Требование	Ценность
Минимальный поддерживаемый клиент	Доступно в Microsoft Windows 2000 и более поздних версиях Windows.
целевая платформа	Рабочий стол
Header	setupapi.h (include Setupapi.h)
Library	Setupapi.lib
DLL	Setupapi.dll
Набор API	ext-ms-win-setupapi-classinstallers-l1-1-0 (представлено в Windows 8)

См. также

SP_DEVINFO_DATA

SetupDiCreateDeviceInfo

SetupDiDeleteDeviceInfo

SetupDiEnumDeviceInterfaces

SetupDiOpenDeviceInfo