LightSensor.ReportInterval Eigenschaft

Definition

Namespace:

Windows.Devices.Sensors

Ruft das aktuelle Berichtsintervall für den Umgebungslichtsensor ab oder legt es fest.

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

Eigenschaftswert

UInt32

unsigned int

uint32_t

Das aktuelle Berichtsintervall in Millisekunden.

Hinweise

Das Berichtsintervall wird auf einen Standardwert festgelegt, der je nach Implementierung des Sensortreibers variiert. Wenn Ihre App diesen Standardwert nicht verwenden möchte, sollten Sie das Berichtsintervall auf einen Wert ungleich 0 festlegen, bevor Sie einen Ereignishandler registrieren oder GetCurrentReading aufrufen. Der Sensor versucht dann, Ressourcen zuzuordnen, um die Anforderungen der Anwendung zu erfüllen, während die Anforderungen anderer Apps, die den Sensor verwenden, ausgeglichen werden.

Änderungen am Berichtsintervall, nachdem ein Ereignishandler registriert oder GetCurrentReading aufgerufen wurde, können sich auf die Übermittlung nachfolgender Sensormesswerte beziehen.

Wenn eine Anwendung mit dem Sensor fertig ist, sollte sie den Sensor explizit auf sein Standardberichtsintervall zurückgeben, indem er es auf 0 (null) festlegt. Dies ist wichtig für die Energieerhaltung, insbesondere wenn eine Sprache verwendet wird, die das Sensorobjekt vor der Garbage Collection auf unbestimmte Zeit aktiv hält.

Die Anwendung sollte die MinimumReportInterval-Eigenschaft vor dem Festlegen des Berichtsintervalls konsultieren, um sicherzustellen, dass der Sensor das angeforderte Berichtsintervall einhalten kann. Das Festlegen eines Werts unter dem unterstützten Mindestintervall löst entweder eine Ausnahme aus oder weist nicht definierte Ergebnisse auf.

Obwohl die Anwendung diesen Wert festlegen kann, um ein bestimmtes Berichtsintervall anzufordern, bestimmt der Treiber das tatsächliche Berichtsintervall basierend auf interner Logik. Beispielsweise kann der Treiber das kürzeste Berichtsintervall verwenden, das von jedem Aufrufer angefordert wird.

Wenn der Wert auf null festgelegt ist, verwendet der Treiber sein Standardberichtsintervall. Wie beim Anfordern eines bestimmten Intervalls kann der Treiber basierend auf anderen Clientanforderungen und interner Logik ein anderes Intervall auswählen.

Die Sensorplattform legt die Änderungsempfindlichkeit für Umgebungslichtsensoren automatisch basierend auf dem aktuellen Berichtsintervall fest. In dieser Tabelle werden die Änderungsempfindlichkeitswerte für bestimmte Intervalle angegeben.

Aktuelles Berichtsintervall	Ändern der Vertraulichkeit
1 ms – 16 ms	1%
17 ms – 32 ms	1%
>= 33 ms	5 %