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


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

Метод 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.

Комментарии

Свойства описывают устройство датчика, а не поля данных, содержащие данные, созданные датчиком. Определяемые платформой свойства определяются в sensors.h.

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

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

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

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

Требования

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

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

ISensorDriver

ISensorDriver::OnGetProperties