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 ( |