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

Функция 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.

Комментарии

Вызывающий объект этой функции должен удалить возвращенный набор сведений об устройстве, если он больше не нужен, вызвав SetupDiDeкистралистDeviceInfoList.

Чтобы создать список сведений об устройствах для удаленного компьютера, используйте SetupDiCreateDeviceInfoListEx.

Требования

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

SetupDiCreateDeviceInfoListEx

SetupDiDeкистраяDeviceInfoList

SetupDiGetClassDevs

SetupDiGetDeviceInfoListClass