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

Статья
08/26/2023

Функция SetupDiCreateDeviceInfoList создает пустой набор сведений об устройстве и при необходимости связывает набор с классом настройки устройства и окном верхнего уровня.

Синтаксис

WINSETUPAPI HDEVINFO SetupDiCreateDeviceInfoList(
  [in, optional] const GUID *ClassGuid,
  [in, optional] HWND       hwndParent
);

Параметры

[in, optional] ClassGuid

Указатель на GUID класса настройки устройства, который необходимо связать с вновь созданным набором сведений об устройстве. Если указан этот параметр, в этот набор сведений об устройстве могут быть включены только устройства этого класса. Если этот параметр имеет значение NULL, набор сведений об устройстве не связан с определенным классом настройки устройства.

[in, optional] hwndParent

Дескриптор окна верхнего уровня, используемый для любого пользовательского интерфейса, связанного с действиями, не зависящими от устройства (например, диалоговое окно выбора устройства, использующее список драйверов глобального класса). Этот дескриптор является необязательным и может иметь значение NULL. Если определенное окно верхнего уровня не требуется, задайте для hwndParentзначение NULL.

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

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

Требования


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

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

SetupDiCreateDeviceInfoListEx

SetupDiDeкистраяDeviceInfoList

SetupDiGetClassDevs

SetupDiGetDeviceInfoListClass

Поделиться через