CustomSensor.ReportInterval Eigenschaft

Definition

Namespace:

Windows.Devices.Sensors.Custom

Ruft das aktuelle Berichtsintervall für den Sensor 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 = customSensor.reportInterval;
customSensor.reportInterval = uInt32;

Public Property ReportInterval As UInteger

Eigenschaftswert

UInt32

unsigned int

uint32_t

Das aktuelle Berichtsintervall für den Sensor.

Hinweise

Das Berichtsintervall wird in Millisekunden angegeben.

Das Berichtsintervall wird auf einen Standardwert festgelegt, der je nach Implementierung des Sensortreibers variiert. Wenn Ihre App diesen Standardwert nicht verwenden möchte, legen Sie das Berichtsintervall auf einen Wert ungleich null fest, bevor Sie einen Ereignishandler registrieren oder GetCurrentReading aufrufen. Der Sensor versucht dann, Ressourcen zuzuweisen, um die Anforderungen der App zu erfüllen, aber der Sensor muss auch die Anforderungen anderer Apps, die den Sensor verwenden, ausgleichen.

Änderungen am Berichtsintervall, nachdem ein Ereignishandler registriert oder GetCurrentReading aufgerufen wurde, gelten möglicherweise für die Übermittlung nachfolgender Sensorlesevorgänge.

Wenn eine App hingegen mit dem Sensor fertig ist, wird empfohlen, den Sensor explizit auf das Standardberichtsintervall zurückzugeben, indem er auf 0 festgelegt wird. 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.

Es wird empfohlen, dass die App die MinimumReportInterval-Eigenschaft vor dem Festlegen des Berichtsintervalls konsultieren, um sicherzustellen, dass der Sensor das angeforderte Berichtsintervall einhalten kann. Wenn Sie einen Wert unterhalb des unterstützten Mindestintervalls festlegen, wird entweder eine Ausnahme ausgelöst oder es werden nicht definierte Ergebnisse angezeigt.

Obwohl die App 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 Sie einen Wert von null festlegen, wird der Treiber aufgefordert, sein Standardberichtsintervall zu verwenden. Wie beim Anfordern eines bestimmten Intervalls kann der Treiber basierend auf anderen Clientanforderungen und interner Logik ein anderes Intervall auswählen.

Die benutzerdefinierte Sensorplattform legt die Änderungsempfindlichkeit für benutzerdefinierte Sensoren basierend auf dem aktuellen Berichtsintervall automatisch fest. In dieser Tabelle werden die Änderungssensitivitätswerte für bestimmte Intervalle angegeben.

Aktuelles Berichtsintervall (in Millisekunden angegeben)	Vertraulichkeit ändern (als G-Force angegeben)
1 ms – 16 ms	0,01 G
17 ms – 32 ms	0,02 G
>= 33 ms	0,05 G