Accelerometer.ReportInterval Eigenschaft

Definition

Namespace:

Windows.Devices.Sensors

Ruft das aktuelle Berichtsintervall für den Beschleunigungsmesser 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 = accelerometer.reportInterval;
accelerometer.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 Null festlegen, bevor Sie einen Ereignishandler registrieren oder GetCurrentReading aufrufen. Der Sensor versucht dann, Ressourcen zuzuweisen, 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, gelten möglicherweise für die Übermittlung nachfolgender Sensormesswerte.

Wenn eine Anwendung hingegen mit dem Sensor fertig ist, sollte sie den Sensor explizit auf sein Standardberichtsintervall zurückgeben, indem er ihn auf 0 festlegt. Dies ist wichtig für die Energieeinsparung, 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 0 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.