Поделиться через

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

  • Статья

Задает свойства в интерфейсе программного устройства.

Синтаксис

HRESULT SwDeviceInterfacePropertySet(
  [in] HSWDEVICE         hSwDevice,
  [in] PCWSTR            pszDeviceInterfaceId,
  [in] ULONG             cPropertyCount,
  [in] const DEVPROPERTY *pProperties
);

Параметры

[in] hSwDevice

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

[in] pszDeviceInterfaceId

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

[in] cPropertyCount

Количество структур DEVPROPERTY в массиве pProperties .

[in] pProperties

Массив структур DEVPROPERTY, содержащий свойства, устанавливаемые в интерфейсе .

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

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

Комментарии

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

Существует небольшое различие между свойствами, которые задаются в рамках вызова SwDeviceInterfaceRegister , и свойствами, которые позже задаются путем вызова SwDeviceInterfacePropertySet. Свойства, заданные как часть SwDeviceInterfaceRegister , хранятся в памяти; Если устройство удалено или драйвер null очищает хранилища свойств, эти свойства снова записываются функцией API программного устройства при повторном перечислении устройств PnP. Все это прозрачно для клиента. Свойства, заданные с помощью SwDeviceInterfacePropertySet после перечисления, не сохраняются в памяти. Но если задать свойство с помощью SwDeviceInterfaceRegister, можно обновить значение с помощью SwDeviceInterfacePropertySet, и это обновление будет применено к значению в памяти, а также к сохраненного хранилища.

SwDeviceInterfacePropertySet можно использовать только для задания свойств в хранилище операционной системы для интерфейса.

Требования

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