SetupDiDestroyDriverInfoList 函数 (setupapi.h)
SetupDiDestroyDriverInfoList 函数删除驱动程序列表。
语法
WINSETUPAPI BOOL SetupDiDestroyDriverInfoList(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[in] DWORD DriverType
);
参数
[in] DeviceInfoSet
包含要删除的驱动程序列表 的设备信息集 的句柄。
[in, optional] DeviceInfoData
指向 SP_DEVINFO_DATA 结构的指针，该结构指定 DeviceInfoSet 中的设备信息元素。 此参数是可选的，可以设置为 NULL。 如果指定此参数， SetupDiDestroyDriverInfoList 将删除指定设备的驱动程序列表。 如果此参数为 NULL， 则 SetupDiDestroyDriverInfoList 将删除与 DeviceInfoSet 关联的全局类驱动程序列表。
[in] DriverType
要删除的驱动程序列表的类型，必须是以下值之一：
SPDIT_CLASSDRIVER
删除类驱动程序的列表。 如果 DeviceInfoData 为 NULL，则必须指定此驱动程序列表类型。
SPDIT_COMPATDRIVER
删除指定设备的兼容驱动程序列表。 如果指定了此驱动程序列表类型，则必须指定 DeviceInfoData。
返回值
如果成功，函数将返回 TRUE 。 否则，它将返回 FALSE ，并且可以通过调用 GetLastError 来检索记录的错误。
注解
如果当前选定的驱动程序是要删除的列表的成员，则重置所选内容。
如果要删除类驱动程序列表，则会为相应的设备信息集或设备信息元素重置DI_FLAGSEX_DIDINFOLIST和DI_DIDCLASS标志。 DI_MULTMFGS标志也会重置。
如果销毁兼容的驱动程序列表，则会为相应的设备信息元素重置DI_FLAGSEX_DIDCOMPATINFO和DI_DIDCOMPAT标志。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 在 Microsoft Windows 2000 及更高版本的 Windows 中可用。 |
| 目标平台 | 桌面 |
| 标头 | setupapi.h (包括 Setupapi.h) |
| Library | Setupapi.lib |
| DLL | Setupapi.dll |
| API 集 | ext-ms-win-setupapi-classinstallers-l1-1-2 (在 Windows 10 版本 10.0.14393 中引入) |