CustomSensor.ReportInterval 属性

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

编辑

获取或设置传感器的当前报告间隔。

public:
 property unsigned int ReportInterval { unsigned int get(); void set(unsigned int value); };

uint32_t ReportInterval();

void ReportInterval(uint32_t value);

public uint ReportInterval { get; set; }

var uInt32 = customSensor.reportInterval;
customSensor.reportInterval = uInt32;

Public Property ReportInterval As UInteger

UInt32

unsigned int

uint32_t

传感器的当前报告间隔。

报告间隔以毫秒为单位指定。

报告间隔将设置为默认值，该值因传感器驱动程序的实现而异。如果你的应用不想使用此默认值，请在注册事件处理程序或调用 GetCurrentReading 之前将报告间隔设置为非零值。然后，传感器将尝试分配资源以满足应用的要求，但传感器还必须平衡使用传感器的其他应用的需求。

注册事件处理程序或调用 GetCurrentReading 后对报告间隔的更改可能适用于后续传感器读数的传递。

相反，当应用使用完传感器时，我们建议它通过将传感器设置为零，将传感器显式返回到其默认报告间隔。这对于节能非常重要，尤其是在使用在垃圾回收之前可能使传感器对象无限期保持活动状态的语言时。

我们建议应用在设置报告间隔之前查阅 MinimumReportInterval 属性，以确保传感器能够遵循请求的报告间隔。将值设置为低于支持的最小间隔将触发异常或产生未定义的结果。

尽管应用可以设置此值来请求特定的报告间隔，但驱动程序将根据内部逻辑确定实际的报告间隔。例如，驱动程序可能使用任何调用方请求的最短报告间隔。

将值设置为零会请求驱动程序使用其默认报告间隔。与请求特定间隔一样，驱动程序可以根据其他客户端请求和内部逻辑选择不同的间隔。

自定义传感器平台根据当前报告间隔自动设置自定义传感器的更改敏感度。此表指定给定间隔的更改敏感度值。