Share via

Метод ISensorDriver::OnGetProperties (sensorsclassextension.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.

Комментарии

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

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

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

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

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

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

Требования

Требование Значение
Целевая платформа Windows
Header sensorsclassextension.h
Библиотека SensorsClassExtension.lib

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

ISensorDriver