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 中引入)

另请参阅

SetupDiBuildDriverInfoList