Compass.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 = compass.reportInterval;
compass.reportInterval = uInt32;

Public Property ReportInterval As UInteger

UInt32

unsigned int

uint32_t

目前的報表間隔，以毫秒為單位。

報表間隔會設定為預設值，根據感應器驅動程式的實作而有所不同。如果您的應用程式不想使用此預設值，您應該在註冊事件處理常式或呼叫 GetCurrentReading之前，將報表間隔設定為非零值。接著，感應器會嘗試配置資源以滿足應用程式的需求，同時使用感應器平衡其他應用程式的需求。

在註冊事件處理常式或呼叫 GetCurrentReading 之後，報表間隔的變更可能會套用至後續感應器讀數的傳遞。

相反地，當應用程式使用感應器完成時，它應該藉由將感應器設定為零，明確地將感應器傳回其預設報表間隔。這對於電源調整很重要，特別是在使用可能會讓感應器物件在垃圾收集之前無限期使用的語言時。

應用程式應該先參閱 MinimumReportInterval 屬性，再設定報表間隔，以確保感應器可以接受要求的報表間隔。設定低於最低支援間隔的值會觸發例外狀況或未定義的結果。

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

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

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