Sensoreigenschaften
Die Sensor- und Standortplattform definiert Konstanten, die Eigenschaften für Sensoren identifizieren. Sensorhersteller können auch eigene Eigenschaften definieren.
Die Plattform definiert die folgenden PROPERTYKEY-Werte für Sensoreigenschaften. Diese Eigenschaften sind schreibgeschützt, sofern nicht anders angegeben.
Jede plattformdefinierte Sensoreigenschaft PROPERTYKEY basiert auf einer gemeinsamen GUID mit dem Namen SENSOR_PROPERTY_COMMON_GUID: {7F8383EC-D3EC-495C-A8CF-B8BBE85C2920}.
Wichtig
Verwenden Sie diesen Basiswert nicht, um Ihre eigenen Eigenschaftenschlüssel zu definieren.
Werte für Eigenschaften, die als Lese-/Schreibzugriff festgelegt sind, können von der Clientanwendung angegeben werden. Werte für als statisch festgelegte Eigenschaften dürfen sich im Laufe der Zeit nicht ändern. Als erforderlich festgelegte Eigenschaften müssen vom Sensor unterstützt werden.
| Eigenschaftenschlüsselname und PID | type | BESCHREIBUNG |
|---|---|---|
| SENSOR_PROPERTY_ACCURACY (PID = 17) |
VT_UNKNOWN | Schreibgeschützt. IPortableDeviceValues-Objekt , das Sensordatentypnamen und die zugeordneten Genauigkeiten enthält. Genauigkeitswerte stellen mögliche Abweichungen von true-Werten dar. Genauigkeitswerte werden mit den gleichen Einheiten wie das Datenfeld ausgedrückt, sofern nicht anders dokumentiert. |
| SENSOR_PROPERTY_CHANGE_SENSITIVITY (PID = 14) |
VT_UNKNOWN | Lese-/Schreibzugriff. IPortableDeviceValues-Objekt , das Sensordatentypnamen und die zugehörigen Änderungsempfindlichkeitswerte enthält. Änderungssensitivitätswerte enthalten Anforderungen über den Betrag, um den sich das Datenfeld ändern soll, bevor das SENSOR_EVENT_DATA_UPDATED-Ereignis ausgelöst wird. Vertraulichkeitswerte werden mit den gleichen Einheiten wie das Datenfeld ausgedrückt, sofern nicht anders dokumentiert. Bei einigen Sensoren wird die Änderungsempfindlichkeit als tatsächlicher Wert interpretiert. Ein Änderungsempfindlichkeitswert von 2 für SENSOR_DATA_TYPE_TEMPERATURE_CELSIUS stellt beispielsweise eine Empfindlichkeit von plus oder minus 2 Grad Celsius dar. Bei anderen Sensoren, wie dem Umgebungslichtsensor (ALS), wird die Änderungsempfindlichkeit als Prozent interpretiert. Eine Änderungssensitivität von 2 für SENSOR_DATA_TYPE_LIGHT_LEVEL_LUX stellt also plus oder minus 2% von LUX dar. Sie können diesen Wert festlegen, um eine bestimmte Änderungsempfindlichkeit anzufordern, aber mehrere Anwendungen können denselben Sensor verwenden. Daher bestimmen Sensoren die wahre Änderungssensitivität basierend auf ihrer internen Logik. Beispielsweise kann der Sensor immer die kleinste Änderungsempfindlichkeit verwenden, die von einer der Anwendungen angefordert wird. Wenn eine Anwendung diese Eigenschaft auf VT_NULL festlegt, sollte der Gerätetreiber SENSOR_PROPERTY_CHANGE_SENSITIVITY auf den Standardwert zurücksetzen. |
| SENSOR_PROPERTY_CONNECTION_TYPE (PID = 11) |
VT_UI4 | Schreibgeschützt. SensorConnectionType-Wert , der den aktuellen Verbindungstyp enthält. |
| SENSOR_PROPERTY_CURRENT_REPORT_INTERVAL (PID = 13) |
VT_UI4 | Lese-/Schreibzugriff. Die aktuelle verstrichene Zeit für die Generierung von Sensordatenberichten in Millisekunden. Das Festlegen eines Werts von null signalisiert dem Treiber, entweder das Standardberichtsintervall oder das kleinste Berichtsintervall zurückzugeben. Wenn nur ein Client verbunden ist, sollte der Treiber das Standardberichtsintervall zurückgeben. Wenn mehrere Clients verbunden sind, sollte der Treiber das kleinste Intervall zurückgeben, das von einem dieser Clients angefordert wird. Anwendungen können diesen Wert festlegen, um ein bestimmtes Berichtsintervall anzufordern, aber mehrere Anwendungen können denselben Treiber verwenden. Daher bestimmen Treiber das wahre Berichtsintervall basierend auf interner Logik. Beispielsweise kann der Treiber immer das kürzeste Berichtsintervall verwenden, das von jedem Aufrufer angefordert wird. Ein Beispiel für die Verwendung dieser Eigenschaft finden Sie unter Verwenden von Sensor-API-Ereignissen. |
| SENSOR_PROPERTY_DESCRIPTION (PID = 10) |
VT_LPWSTR | Schreibgeschützt. Die Sensorbeschreibungszeichenfolge. |
| SENSOR_PROPERTY_DEVICE_PATH (PID = 15) |
VT_LPWSTR | Schreibgeschützt. Identifiziert eindeutig die Geräteinstanz, der der Sensor zugeordnet ist. Sie können diese Eigenschaft verwenden, um zu bestimmen, ob ein Gerät mehrere Sensoren enthält. Gerätetreiber müssen diese Eigenschaft nicht unterstützen, da die Plattform diesen Wert für Anwendungen bereitstellt, ohne Treiber abzufragen. |
| SENSOR_PROPERTY_FRIENDLY_NAME (PID = 9) |
VT_LPWSTR | Schreibgeschützt. Erforderlich, statisch. Der Anzeigename für das Gerät. |
| SENSOR_PROPERTY_LIGHT_RESPONSE_CURVE (PID = 16) |
VT_VECTOR| VT_UI1 | Schreibgeschützt. Ein gezähltes Array, das Wertepaare enthält, die eine Zuordnung zwischen Umgebungslichtstufen und Offsets ermöglichen. Diese Werte werden in Prozent ausgedrückt. Das Feature adaptive Helligkeit in Windows wendet diese Werte auf die aktuelle Anzeigehelligkeitseinstellung des Benutzers an. Daten für Vektortypen werden immer als VT_UI1 serialisiert (ein Array von 1-Byte-Zeichen ohne Vorzeichen). Diese Eigenschaft enthält tatsächlich jeden Wert als 4-Byte-Ganzzahl ohne Vorzeichen (VT_UI4). Informationen zum Arbeiten mit Arrays finden Sie unter Abrufen von Vektortypen. |
| SENSOR_PROPERTY_LOCATION_DESIRED_ACCURACY (PID = 19) |
VT_UI4 | Lese-/Schreibzugriff. Ein Wert aus der LOCATION_DESIRED_ACCURACY-Enumeration , der den Typ der Von einer Clientanwendung angeforderten Genauigkeitsbehandlung angibt. LOCATION_DESIRED_ACCURACY_DEFAULT (0) gibt an, dass der Sensor die Genauigkeit verwenden sollte, für die er die Energienutzung und andere Kostenaspekte optimieren kann. LOCATION_DESIRED_ACCURACY_HIGH (1) gibt an, dass der Sensor einen möglichst genauen Bericht liefern soll. Dies beinhaltet die Verwendung von kostenpflichtigen Diensten oder Diensten mit höherem Akkuverbrauch oder höherer Verbindungsbandbreite. |
| SENSOR_PROPERTY_MANUFACTURER (PID = 6) |
VT_LPWSTR | Schreibgeschützt. Erforderlich, statisch. Der Name des Herstellers. |
| SENSOR_PROPERTY_MIN_REPORT_INTERVAL (PID = 12) |
VT_UI4 | Schreibgeschützt. Erforderlich, statisch. Das Mindestintervall, das die Hardware für die Generierung von Sensordatenberichten in Millisekunden unterstützt. |
| SENSOR_PROPERTY_MODEL (PID = 7) |
VT_LPWSTR | Schreibgeschützt. Erforderlich, statisch. Der Name des Sensormodells. |
| SENSOR_PROPERTY_PERSISTENT_UNIQUE_ID (PID = 5) |
VT_CLSID | Schreibgeschützt. Erforderlich, statisch. Eine GUID, die den Sensor identifiziert. Dieser Wert muss für jeden Sensor auf einem Gerät oder für Geräte mit demselben Modell wie auf dem Computer eindeutig sein. Diese Eigenschaft enthält den gleichen Wert, der durch aufrufen von ISensor::GetID abgerufen wird. |
| SENSOR_PROPERTY_RANGE_MAXIMUM (PID = 21) |
VT_UNKNOWN | Schreibgeschützt. IPortableDeviceValues-Objekt , das Sensordatenfeldnamen und die zugehörigen Maximalwerte enthält. |
| SENSOR_PROPERTY_RANGE_MINIMUM (PID = 20) |
VT_UNKNOWN | Schreibgeschützt. IPortableDeviceValues-Objekt , das Sensordatenfeldnamen und die zugehörigen Mindestwerte enthält. |
| SENSOR_PROPERTY_RESOLUTION (PID = 18) |
VT_UNKNOWN | Schreibgeschützt. IPortableDeviceValues-Objekt , das Sensordatenfeldnamen und die zugehörigen Auflösungen enthält. Auflösungswerte stellen die Vertraulichkeit für Änderungen im Datenfeld dar. Auflösungswerte werden mit den gleichen Einheiten wie das Datenfeld ausgedrückt, sofern nicht anders dokumentiert. |
| SENSOR_PROPERTY_SERIAL_NUMBER (PID = 8) |
VT_LPWSTR | Schreibgeschützt. Erforderlich, statisch. Die Seriennummer des Sensors. |
| SENSOR_PROPERTY_STATE (PID = 3) |
VT_UI4 | Schreibgeschützt. Erforderlich. SensorState-Wert , der den aktuellen Sensorzustand enthält. Hinweis Um diese Eigenschaft zu aktualisieren, rufen Sie ein Zustandsänderungsereignis aus, indem Sie ISensorClassExtension::P ostStateChange aufrufen. |
| SENSOR_PROPERTY_TURN_ON_OFF_NMEA (PID = 3) |
VT_UI4 | Lese-/Schreibzugriff. Wenn TRUE, wird ein NMEA-Satz in Datenberichten eingeschlossen. Bei False ist der NMEA-Satz nicht enthalten. |
| SENSOR_PROPERTY_TYPE (PID = 2) |
VT_CLSID | Schreibgeschützt. Erforderlich, statisch. Eine GUID , die den Sensortyp identifiziert. Plattformdefinierte Sensortypen werden in Sensors.h definiert. |
Die folgende WpD-Eigenschaft (Windows Portable Devices) muss von allen Sensoren unterstützt werden.
| Eigenschaftenschlüssel | type | BESCHREIBUNG |
|---|---|---|
| WPD_FUNCTIONAL_OBJECT_CATEGORY | VT_CLSID | Schreibgeschützt. Erforderlich, statisch. Definiert die Sensorkategorie. |
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7 |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Kopfzeile | sensors.h |
Siehe auch
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für