Pedometer.ReportInterval Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft das aktuelle Berichtsintervall für den Schrittzähler 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 = pedometer.reportInterval;
pedometer.reportInterval = uInt32;Public Property ReportInterval As UIntegerEigenschaftswert
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 PedometerReading 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 PedometerReading 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.