Функция SetupDiRemoveDeviceInterface (setupapi.h)

Статья
08/26/2023

Функция SetupDiRemoveDeviceInterface удаляет из системы зарегистрированный интерфейс устройства.

Синтаксис

WINSETUPAPI BOOL SetupDiRemoveDeviceInterface(
  [in]      HDEVINFO                  DeviceInfoSet,
  [in, out] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData
);

Параметры

[in] DeviceInfoSet

Указатель на набор сведений об устройстве , содержащий удаляемую интерфейс устройства. Этот дескриптор обычно возвращается setupDiGetClassDevs.

[in, out] DeviceInterfaceData

Указатель на структуру SP_DEVICE_INTERFACE_DATA , указывающую интерфейс устройства в DeviceInfoSet для удаления. Этот указатель обычно возвращается setupDiEnumDeviceInterfaces.

После удаления интерфейса эта функция устанавливает флаг SPINT_REMOVED в DeviceInterfaceData. Флаги. Он также очищает флаг SPINT_ACTIVE, но имейте в виду, что этот флаг уже должен был быть снят до вызова этой функции.

Возвращаемое значение

SetupDiRemoveDeviceInterface возвращает значение TRUE , если функция выполнена без ошибок. Если функция завершилась ошибкой, она возвращает значение FALSE , и код ошибки для сбоя можно получить, вызвав Метод GetLastError.

Чтобы удалить интерфейс устройства, его необходимо отключить. Если интерфейс включен, эта функция завершается сбоем, и GetLastError возвращает ERROR_DEVICE_INTERFACE_ACTIVE. Отключите интерфейс, используя любой механизм, зависящий от интерфейса (например, IOCTL). Если вызывающий объект не может отключить интерфейс и его необходимо удалить, вызывающий объект должен остановить базовое устройство с помощью SetupDiChangeStateState. Остановка устройства отключает все интерфейсы, предоставляемые устройством.

Требования


Минимальная версия клиента	Доступно в Microsoft Windows 2000 и более поздних версиях Windows.
Целевая платформа	Персональный компьютер
Верхняя часть	setupapi.h (включая Setupapi.h)
Библиотека	Setupapi.lib
DLL	Setupapi.dll