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