Функция SwDeviceInterfaceSetState (swdevice.h)

Включает или отключает интерфейс устройства для программного устройства.

Синтаксис

HRESULT SwDeviceInterfaceSetState(
  [in] HSWDEVICE hSwDevice,
  [in] PCWSTR    pszDeviceInterfaceId,
  [in] BOOL      fEnabled
);

Параметры

[in] hSwDevice

Дескриптор HSWDEVICE для программного устройства, для регистрации интерфейса устройства.

[in] pszDeviceInterfaceId

Строка, определяющая интерфейс для включения или отключения.

[in] fEnabled

Логическое значение, указывающее, следует ли включать или отключать интерфейс. Значение TRUE для включения; Значение FALSE для отключения.

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

S_OK возвращается, если swDeviceInterfaceSetState успешно включил или отключил интерфейс; в противном случае — соответствующее значение ошибки.

Комментарии

SwDeviceInterfaceSetState можно вызвать только после того, как операционная система вызовет функцию обратного вызова SW_DEVICE_CREATE_CALLBACK клиентского приложения, чтобы уведомить клиентское приложение о завершении перечисления устройств.

SwDeviceInterfaceSetState можно использовать только для управления интерфейсами, которые были ранее зарегистрированы в SwDeviceInterfaceRegister, для программного устройства, представляющего hSwDevice.

Клиентские приложения используют SwDeviceInterfaceSetState для управления состоянием интерфейса. Программное устройство изменяет фактическое состояние интерфейса при необходимости. Например, клиентское приложение отключает и повторно включает интерфейс, если устройство повторно перечислено по какой-либо причине. Состояние всегда пытается отразить требуемое состояние клиентского приложения.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8
Минимальная версия сервера	Windows Server 2012
Целевая платформа	Универсальное
Верхняя часть	swdevice.h
Библиотека	Swdevice.lib; OneCoreUAP.lib в Windows 10
DLL	Cfgmgr32.dll