Метод ISensorDriver::OnSetProperties (sensorsclassextension.h)

Статья
08/07/2023

Метод ISensorDriver::OnSetProperties задает значения для указанного списка свойств.

Синтаксис

HRESULT OnSetProperties(
  [in]  IWDFFile              *pClientFile,
  [in]  LPWSTR                pwszSensorID,
  [in]  IPortableDeviceValues *pPropertiesToSet,
  [out] IPortableDeviceValues **ppResults
);

Параметры

[in] pClientFile

Указатель на интерфейс IWDFFile , представляющий объект файла для приложения, задающий значения свойств.

[in] pwszSensorID

LPWSTR , содержащий идентификатор датчика, для которого клиентское приложение задает значения свойств.

[in] pPropertiesToSet

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

[out] ppResults

Адрес указателя IPortableDeviceValues , который получает список успешно заданных свойств и их новые значения. Если свойство не задано, новое значение содержит код ошибки HRESULT.

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

Если операция выполнена успешно, этот метод возвращает S_OK. В противном случае этот метод возвращает один из кодов ошибок, определенных в Winerror.h.

Список свойств, предоставляемых через pPropertiesToSet , обычно представляет собой подмножество списка, возвращенного с помощью ISensorDriver::OnGetSupportedProperties. Однако расширение класса датчика не применяет это условие к клиентским приложениям.

Расширение класса датчика отвечает за освобождение всех структур PROPVARIANT , возвращаемых этим методом.

IPortableDeviceValues описано в статье Переносимые устройства Windows.

Примечание Этот метод будет вызываться только в том случае, если пользователь включил датчик на панели управления Расположение и другие датчики .

Требования

Требование	Значение
Минимальная версия клиента	Windows 7, доступно в Windows 7.
Минимальная версия сервера	Ни одна версия не поддерживается
Целевая платформа	Персональный компьютер
Верхняя часть	sensorsclassextension.h
Библиотека	SensorsClassExtension.lib

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

ISensorDriver

ISensorDriver::OnGetProperties

Share via