Informationen zu Sensorkonstanten

Die Windows-Plattform "Sensor and Location" verwendet Konstanten auf vielfältige Weise. 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 plattformdefinierte Sensorkonstanten finden Sie unter Konstanten.

Sensor- und Datenorganisation

Die Plattform organisiert Sensoren und Daten wie folgt:

• Kategorien stellen breite Klassen von Sensorgeräten dar. Mit Kategorien können Sie Sensoren gruppieren, die wahrscheinlich ähnliche Arten von Informationen bereitstellen oder anderweitig in irgendeiner Weise zusammenhängen. Jede Kategorie wird durch eine GUID-Konstante dargestellt. Beispielsweise gehören Sensoren, die Breiten- und Längengradkoordinaten melden, zur Kategorie Des Standortsensors. Dies wird durch die SENSOR_CATEGORY_LOCATION-Konstante dargestellt.
• Sensortypen stellen bestimmte Arten von Sensoren dar. Jeder Sensortyp passt in eine bestimmte Kategorie. Zwei Sensoren unterschiedlicher Typen können derselben Kategorie oder unterschiedlichen Kategorien angehören. Jeder Sensortyp wird durch eine GUID-Konstante dargestellt. Beispielsweise würde ein globaler Positionierungssystemsensor durch die SENSOR_TYPE_LOCATION_GPS-Konstante identifiziert. Ein Sensor, der den aktuellen Standort mithilfe einer IP-Adresse bereitstellt, wird jedoch durch die SENSOR_TYPE_LOCATION_LOOKUP-Konstante identifiziert. Beide Sensoren würden jedoch zur Kategorie Des Standortsensors gehören.
• Datentypen stellen bestimmte Arten von Informationen dar, die der Sensor bereitstellen kann. Sensordatentypen können den tatsächlichen Messwert enthalten, z. B. Die Höhe; Informationen zu den Einheiten, die zum Ausdrücken der Daten verwendet werden, z. B. Zähler; und Referenzpunkte für die Daten, z. B. Meeresspiegel. Jeder Datentyp wird durch eine PROPERTYKEY-Konstante dargestellt. Der Datentyp, der die Höhe über dem Meeresspiegel in Metern darstellt, wird beispielsweise durch die SENSOR_DATA_TYPE_ALTITUDE_SEALEVEL_METERS-Konstante identifiziert.
• Beim Melden von Daten soll ein Wert in einem Datenfeld enthalten sein, und eine Sammlung verwandter Datenfelder bildet einen Datenbericht. Datenberichte werden mithilfe der IPortableDeviceValues-Schnittstelle zusammengepackt. Jeder Datenbericht muss mindestens ein gültiges Datenfeld und einen Zeitstempel enthalten, der den Zeitpunkt der Erstellung des Datenberichts angibt. Zeitstempel werden durch die SENSOR_DATA_TYPE_TIMESTAMP-Konstante dargestellt.

Andere Konstanten

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

• Sensoreigenschaften, z. B. SENSOR_PROPERTY_DESCRIPTION. Normalerweise 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 denselben Wert vom Sensor zurückgeben. Im Abschnitt Referenz zu Sensoreigenschaften werden diese Informationen für jede Eigenschaft bereitgestellt.
• Ereigniskonstanten, z. B. SENSOR_EVENT_STATE_CHANGED. Ereigniskonstanten umfassen GUIDs, die Ereignistypen darstellen, und PROPERTYKEYs, 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 in eine 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 die Veröffentlichung einer Headerdatei. Weitere Informationen finden Sie in der Dokumentation, die mit dem Sensor bereitgestellt wird.