ISensorDriver：：OnGetProperties 方法 (sensorsclassextension.h)

  • 项目

ISensorDriver：：OnGetProperties 方法从指定传感器检索指定属性的值。

语法

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

参数

pClientFile

指向 IWDFFile 接口的指针，该接口表示请求属性值的应用程序的文件对象。

pwszSensorID

包含客户端应用程序从中请求属性值的传感器的 ID 的 LPWSTR。

pProperties

指向 IPortableDeviceKeyCollection 的指针，该 IPortableDeviceKeyCollection 包含表示所请求属性的 PROPERTYKEY 值的列表。

ppPropertyValues

接收请求的属性值的 IPortableDeviceValues 指针的地址。

返回值

如果操作成功，此方法将返回S_OK。 否则，此方法返回 Winerror.h 中定义的错误代码之一。

注解

属性描述传感器设备，而不是包含传感器生成的数据的数据字段。 平台定义的属性在 sensors.h 中定义。

在用户授予传感器权限之前，应用程序可以访问某些传感器属性信息。 这些项仅限于 sensors.h 中定义的以下 ID：

  • 以“SENSOR_PROPERTY_”开头的任何 PROPERTYKEY 。
  • 以“SENSOR_CATEGORY_”开头的任何类别 GUID 。
此集合中返回的每个 IPortableDeviceValues 对象都必须包含所需属性的值，如 传感器属性 参考部分所述。

传感器类扩展负责释放此方法返回的任何 PROPVARIANT 结构。

传感器属性不得包含可用于标识用户的信息。 有关用户隐私的详细信息，请参阅 传感器和位置平台中的隐私和安全。

IPortableDeviceKeyCollection 和 IPortableDeviceValues 记录在 Windows 可移植设备中。

要求

要求 值
目标平台 Windows
标头 sensorsclassextension.h
Library SensorsClassExtension.lib

另请参阅

ISensorDriver