Функция 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 в sizeof(SP_DEVINFO_DATA).

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

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

Комментарии

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

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

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

Требования

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

См. также раздел

SP_DEVINFO_DATA

SetupDiCreateDeviceInfo

SetupDiDeleteDeviceInfo

SetupDiEnumDeviceInterfaces

SetupDiOpenDeviceInfo