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

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

Синтаксис

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

Параметры

[in] hSwDevice

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

[in] cPropertyCount

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

[in] pProperties

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

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

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

Комментарии

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

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

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

Требования

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