传感器数据报表对象

重要

请改用 UWP 传感器 API 。

基于 COM 的传感器 API 已弃用，不应在新应用程序中使用。 没有计划其他功能或增强功能，并且支持将受到限制。

传感器数据报表对象包含传感器数据。

要使传感器有用，它必须提供有意义的数据。 数据生成的数量和频率因传感器而异。 例如，检测门是否打开的传感器将生成少量 布尔 数据，而运动传感器可能会持续生成多个数据项。 为了标准化程序接收数据的方式，传感器 API 使用传感器数据报告对象。

可以通过 ISensorDataReport 接口访问传感器数据报表中的信息。 此接口允许检索数据报表的时间戳，以便确定报表中的信息是否有用。 可以通过两种方式检索数据本身：作为单个数据字段值或作为一组值。 若要以单个值的形式检索数据，请调用 GetSensorValue 方法。 若要检索多个值，请调用 GetSensorValues 方法。

可以使用 PROPERTYKEY 常量指定要从报表中检索的数据或数据字段的类型。 常见传感器类型的数据字段的属性键在 Sensors.h 中定义。