Sensoreigenschaften
Die Plattform Sensor and Location 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 Eigenschaftsschlü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 | BESCHREIBUNG |
|---|---|
|
VT_UNKNOWN Schreibgeschützt. IPortableDeviceValues-Objekt , das Sensordatentypnamen und die zugehörigen Genauigkeiten enthält. Genauigkeitswerte stellen eine mögliche Abweichung von true-Werten dar. Genauigkeitswerte werden mit den gleichen Einheiten wie das Datenfeld ausgedrückt, sofern nicht anders dokumentiert. |
|
VT_UNKNOWN Lese-/Schreibzugriff. IPortableDeviceValues-Objekt , das Sensordatentypnamen und die zugehörigen Änderungsempfindlichkeitswerte enthält. Änderungsempfindlichkeitswerte geben Anforderungen über die Menge an, um die sich das Datenfeld ändern soll, bevor das SENSOR_EVENT_DATA_UPDATED-Ereignis ausgelöst wird. Vertraulichkeitswerte werden mithilfe der 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 Änderungsempfindlichkeit von 2 für SENSOR_DATA_TYPE_LIGHT_LEVEL_LUX entspricht also plus oder minus 2 % von LUX. Sie können diesen Wert festlegen, um eine bestimmte Änderungsempfindlichkeit anzufordern, aber mehrere Anwendungen können denselben Sensor verwenden. Daher bestimmen Sensoren die tatsächliche Änderungsempfindlichkeit 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, setzt der Gerätetreiber SENSOR_PROPERTY_CHANGE_SENSITIVITY auf den Standardwert zurück. |
|
VT_UI4 Schreibgeschützt. SensorConnectionType-Wert , der den aktuellen Verbindungstyp enthält. |
|
VT_UI4 Lese-/Schreibzugriff. Die aktuell verstrichene Zeit für die Generierung von Sensordatenberichten in Millisekunden. Das Festlegen des Werts 0 (null) signalisiert dem Treiber, sein Standardberichtsintervall zu verwenden. Nachdem der Wert 0 (null) für diese Eigenschaft empfangen wurde, muss ein Treiber bei der Abfrage sein Standardberichtsintervall zurückgeben, nicht 0. Anwendungen können diesen Wert festlegen, um ein bestimmtes Berichtsintervall anzufordern, aber mehrere Anwendungen könnten denselben Treiber verwenden. Daher bestimmen Treiber das tatsächliche 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. |
|
VT_LPWSTR Schreibgeschützt. Die Sensorbeschreibungszeichenfolge. |
|
VT_LPWSTR Schreibgeschützt. Identifiziert eindeutig das Gerät instance, dem 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. |
|
VT_LPWSTR Schreibgeschützt. Erforderlich, statisch. Der Anzeigename für das Gerät. |
|
VT_UI4 Schreibgeschützt. Diese Eigenschaft wird bereitgestellt, damit HID-Sensorhersteller und Treiberentwickler einen Sensor identifizieren können, der auf der API-Ebene mit dem Anzeigenamen "unbekannt" angezeigt wird. |
|
VT_VECTOR| VT_UI1 Schreibgeschützt. Ein gezähltes Array, das Wertepaare enthält, die eine Zuordnung zwischen Umgebungslichtwerten und Offsets bereitstellen. Diese Werte werden in Prozent ausgedrückt. Die Adaptive Helligkeitsfunktion in Windows wendet diese Werte auf die aktuelle Anzeigehelligkeitspräferenz des Benutzers an. Daten für Vektortypen werden immer als VT_UI1 serialisiert (ein Array ohne Vorzeichen, 1-Byte-Zeichen). 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. |
|
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 den Stromverbrauch und andere Kostenaspekte optimieren kann. LOCATION_DESIRED_ACCURACY_HIGH (1) gibt an, dass der Sensor den möglichst genauen Bericht liefern sollte. Dies beinhaltet die Verwendung von kostenpflichtigen Diensten oder Diensten mit höherem Akkuverbrauch oder höherer Verbindungsbandbreite. |
|
VT_LPWSTR Schreibgeschützt. Erforderlich, statisch. Der Name des Herstellers. |
|
VT_UI4 Schreibgeschützt. Erforderlich, statisch. Das Mindestintervall, das die Hardware für die Generierung von Sensordatenberichten in Millisekunden unterstützt. |
|
VT_LPWSTR Schreibgeschützt. Erforderlich, statisch. Der Name des Sensormodells. |
|
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. |
|
VT_UKNOWN Schreibgeschützt. IPortableDeviceValues-Objekt , das Sensordatenfeldnamen und die zugehörigen Maximalwerte enthält. |
|
VT_UKNOWN Schreibgeschützt. IPortableDeviceValues-Objekt , das Sensordatenfeldnamen und die zugehörigen Mindestwerte enthält. |
|
VT_UKNOWN 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. |
|
VT_LPWSTR Schreibgeschützt. Erforderlich, statisch. Die Seriennummer des Sensors. |
|
VT_UI4 Schreibgeschützt. Erforderlich. SensorState-Wert , der den aktuellen Sensorzustand enthält. |
|
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 | BESCHREIBUNG |
|---|---|
|
VT_CLSID Schreibgeschützt. Erforderlich, statisch. Definiert die Sensorkategorie. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Nicht unterstützt |
| Header |
|
Siehe auch