LightSensor.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 = lightSensor.reportInterval;
lightSensor.reportInterval = uInt32;

Public Property ReportInterval As UInteger

UInt32

unsigned int

uint32_t

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

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

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

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

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

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

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

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