Freigeben über


Das Sensordatenbericht-Objekt

Von Bedeutung

Verwenden Sie stattdessen die UWP-Sensor-API .

Die COM-basierte Sensor-API ist veraltet und sollte nicht in neuen Anwendungen verwendet werden. Es sind keine zusätzlichen Features oder Verbesserungen geplant, und der Support wird eingeschränkt.

Das Sensordatenberichtsobjekt enthält Sensordaten.

Damit ein Sensor nützlich ist, muss er aussagekräftige Daten bereitstellen. Die Menge und Häufigkeit der Datengenerierung variiert von Sensor zu Sensor. Beispielsweise würde ein Sensor, der erkennt, ob eine Tür geöffnet ist, eine kleine Menge von booleschen Daten generieren, während ein Bewegungssensor kontinuierlich mehrere Datenelemente generiert. Um die Art und Weise zu standardisieren, wie Ihr Programm Daten empfängt, verwendet die Sensor-API das Sensordatenberichtsobjekt.

Sie können über die ISensorDataReport Schnittstelle auf die Informationen in einem Sensordatenbericht zugreifen. Mit dieser Schnittstelle können Sie den Zeitstempel des Datenberichts abrufen, damit Sie bestimmen können, ob die Informationen im Bericht nützlich sind. Sie können die Daten selbst auf zwei Arten abrufen: als einzelner Datenfeldwert oder als Wertesatz. Rufen Sie zum Abrufen von Daten als einzelnen Wert die GetSensorValue--Methode auf. Rufen Sie zum Abrufen mehrerer Werte die GetSensorValues--Methode auf.

Sie geben den Typ der Daten- oder Datenfelder an, die Sie aus dem Bericht abrufen möchten, indem Sie eine PROPERTYKEY- Konstante verwenden. Eigenschaftenschlüssel für Datenfelder gängiger Sensortypen werden in Sensors.h definiert.