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

Метод ISensorDriver::OnGetProperties (sensorclassextension.h)

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

Синтаксис

HRESULT OnGetProperties(
  IWDFFile                     *pClientFile,
  LPWSTR                       pwszSensorID,
  IPortableDeviceKeyCollection *pProperties,
  IPortableDeviceValues        **ppPropertyValues
);

Параметры

pClientFile

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

pwszSensorID

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

pProperties

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

ppPropertyValues

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

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

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

Замечания

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

Приложения могут получить доступ к некоторым сведениям о свойстве датчика, прежде чем пользователь предоставляет разрешение для датчика. Эти элементы ограничены следующими идентификаторами, определенными в датчиках.h:

  • Все PROPERTYKEY, начинающиеся с "SENSOR_PROPERTY_".
  • Любая категория GUID, начинающаяся с "SENSOR_CATEGORY_".
Каждый объект IPortableDeviceValues, возвращаемый в этой коллекции, должен содержать значения необходимых свойств, как описано в разделе Свойств датчика справочника.

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

Свойства датчика не должны содержать сведения, которые можно использовать для идентификации пользователя. Дополнительные сведения о конфиденциальности пользователей см. в конфиденциальности и безопасности вплатформы датчиков и расположений.

IPortableDeviceKeyCollection и IPortableDeviceValues документируются на переносных устройствах Windows.

Требования

Требование Ценность
целевая платформа Виндоус
заголовка sensorclassextension.h
библиотеки SensorClassExtension.lib

См. также

ISensorDriver