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 屬性，再設定報告間隔，以確保感應器可以接受要求的報表間隔。設定低於最小支援間隔的值將會觸發例外狀況或未定義的結果。

雖然應用程式可以設定此值來要求特定的報告間隔，但驅動程式會根據內部邏輯來判斷實際的報告間隔。例如，驅動程式可能會使用任何呼叫端所要求的最短報告間隔。

設定零的值會要求驅動程式使用其預設報告間隔。如同要求特定間隔，驅動程式可能會根據其他用戶端要求和內部邏輯來選擇不同的間隔。

自訂感應器平臺會根據目前的報告間隔，自動設定自訂感應器的變更敏感度。下表會指定指定間隔的變更敏感度值。