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。

注解

如果不再需要此函数,则此函数的调用方必须通过调用 SetupDiDestroyDeviceInfoList 删除返回的设备信息集。

若要为远程计算机创建设备信息列表,请使用 SetupDiCreateDeviceInfoListEx

要求

   
最低受支持的客户端 在 Microsoft Windows 2000 及更高版本的 Windows 中可用。
目标平台 桌面
标头 setupapi.h (包括 Setupapi.h)
Library Setupapi.lib
DLL Setupapi.dll
API 集 在 Windows 8.1) 中引入的 ext-ms-win-setupapi-classinstallers-l1-1-1 (

另请参阅

SetupDiCreateDeviceInfoListEx

SetupDiDestroyDeviceInfoList

SetupDiGetClassDevs

SetupDiGetDeviceInfoListClass