Функция SetupDiDeкистраторИнфолист (setupapi.h)

Функция SetupDiDebaseDriverInfoList удаляет список драйверов.

Синтаксис

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. Если этот параметр указан, SetupDiDe примерыDriverInfoList удаляют список драйверов для указанного устройства. Если этот параметр имеет значение NULL, SetupDiDedriverInfoList удаляет список драйверов глобального класса, связанный с 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)
Библиотека Setupapi.lib
DLL Setupapi.dll
Набор API ext-ms-win-setupapi-classinstallers-l1-1-2 (появилось в Windows 10 версии 10.0.14393)

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

SetupDiBuildDriverInfoList