Informationen zu Sensorkonst konstanten

Die Windows Sensor- und Standortplattform verwendet Konstanten in vielerlei Hinsicht. Die Plattform definiert verschiedene Konstanten, die Sie in Ihrem Sensortreibercode verwenden können. Sensorhersteller können benutzerdefinierte Konstanten definieren. Die Definitionen plattformdefinierter Konstanten finden Sie in der Datei Sensors.h. Ausführliche Informationen zu plattformdefinierten Sensorkonst constants finden Sie unter Konstanten.

Organisation von Sensoren und Daten

Die Plattform organisiert Sensoren und Daten auf folgende Weise.

  • Kategorien stellen breite Klassen von Sensorgeräten dar. Mit Kategorien können Sie Sensoren gruppen, die wahrscheinlich ähnliche Arten von Informationen bereitstellen oder anderweitig in irgendeiner Weise verknüpft sind. Jede Kategorie wird durch eine GUID-Konstante dargestellt. Beispielsweise gehören Sensoren, die Breiten- und Längenkoordinaten melden, zur Kategorie des Standortsensors. Dies wird durch die KONSTANTE SENSOR _ CATEGORY _ LOCATION repräsentiert.
  • Sensortypen stellen bestimmte Arten von Sensoren dar. Jeder Sensortyp passt in eine bestimmte Kategorie. Zwei Sensoren unterschiedlicher Typen können derselben Kategorie oder verschiedenen Kategorien angehören. Jeder Sensortyp wird durch eine GUID-Konstante dargestellt. Beispielsweise würde ein globaler Positionierungssystemsensor durch die GPS-Konstante SENSOR _ TYPE _ LOCATION identifiziert _ werden. Ein Sensor, der den aktuellen Standort mithilfe einer IP-Adresse anfing, würde jedoch durch die KONSTANTE SENSOR _ TYPE _ LOCATION _ LOOKUP identifiziert. Beide Sensoren gehören jedoch zur Kategorie Standortsensor.
  • Datentypen stellen bestimmte Arten von Informationen dar, die der Sensor bereitstellen kann. Sensordatentypen können den tatsächlichen Messwert enthalten, z. B. höhe; Informationen zu den Einheiten, die zum Ausdrücken der Daten verwendet werden, z. B. Meter; und Referenzpunkte für die Daten, z. B. den Seepegel. Jeder Datentyp wird durch eine PROPERTYKEY-Konstante dargestellt. Beispielsweise würde der Datentyp, der die Höhe über dem Wasser in Metern darstellt, durch die Konstante SENSOR _ DATA _ TYPE ALTITUDE _ _ SEALEVEL METERS _ identifiziert.
  • Beim Melden von Daten wird ein Wert als in einem Datenfeld enthalten bezeichnet, und eine Sammlung verwandter Datenfelder besteht aus einem Datenbericht. Datenberichte werden mithilfe der IPortableDeviceValues-Schnittstelle gepackt. Jeder Datenbericht muss mindestens ein gültiges Datenfeld und einen Zeitstempel enthalten, mit dem identifiziert wird, wann der Datenbericht erstellt wurde. Zeitstempel werden durch die SENSOR _ DATA _ TYPE _ TIMESTAMP-Konstante dargestellt.

Andere Konstanten

Das Programm muss auch andere Konstanten verwenden. Diese Konstanten umfassen Folgendes:

  • Sensoreigenschaften, z. B. SENSOR _ PROPERTY _ DESCRIPTION. In der Regel werden diese Konstanten verwendet, um einen Sensor zu beschreiben. Einige Sensoreigenschaften müssen vom Sensor bereitgestellt werden, einige Eigenschaften können von Clientanwendungen festgelegt werden, und einige müssen immer den gleichen Wert vom Sensor zurückgeben. Der Abschnitt Referenz zu Sensoreigenschaften enthält diese Informationen für jede Eigenschaft.
  • Ereigniskonst constants, z. B. SENSOR _ EVENT _ STATE _ CHANGED. Ereigniskonst constants umfassen GUID-Typen, die Ereignistypen darstellen, und PROPERTYKEY s, die Ereignisparametertypen darstellen. Sie verwenden diese Konstanten für Methodenaufrufe, z. B. ISensor::SetEventInterest und ISensor::GetEventInterest.

Benutzerdefinierte Konstanten

Sensorhersteller können benutzerdefinierte Konstanten definieren. Beispielsweise kann ein Sensor zu einer Kategorie gehören, die nicht von der Plattform definiert ist. Bevor Sie einen Sensor verwenden können, der benutzerdefinierte Konstanten definiert, muss der Sensorhersteller die Werte veröffentlichen, z. B. durch Veröffentlichen einer Headerdatei. Weitere Informationen finden Sie in der Dokumentation, die mit dem Sensor bereitgestellt wird.