Allgemeine Sensoreigenschaften
In diesem Artikel werden die Sensoreigenschaften beschrieben, die für alle Sensoren üblich sind.
Die folgende Tabelle zeigt allgemeine Eigenschaften. Weitere Informationen zu den in der Typspalte angezeigten Typen finden Sie in der PROPVARIANT-Struktur.
| Eigenschaftsschlüssel | type | Zugriff (R/O, R/W) | erforderlich/optional | Beschreibung |
|---|---|---|---|---|
| PKEY_Sensor_Type | VT_CLSID | R/O | Erforderlich | Der Sensortyp. Die GUID besteht aus demselben Format wie ein Windows-Sensor (z. B. SENSOR_TYPE_ACCELEROMETER_3D). Weitere Informationen zu Sensortypen finden Sie unter Sensortyp-GUIDs. |
| PKEY_Sensor_State | VT_UI4 | R/O | Erforderlich | Der Zustand des Sensors. Weitere Informationen zu Sensorzuständen finden Sie unter SENSOR_STATE. |
| PKEY_Sensor_MinimumDataInterval_Ms | VT_UI4 | R/O | Erforderlich | Das minimale Zeitintervall (in Millisekunden), das die Hardware für die Generierung von Sensordatenberichten unterstützt. |
| PKEY_Sensor_MaximumDataFieldSize_Bytes | VT_UI4 | R/O | Erforderlich | Die maximale Größe, die in einem ReadFile-Aufruf zurückgegeben wird. Ein ReadFile-Aufruf ermöglicht der nativen API, einen Puffer für ein beliebiges Datenfeld zuzuweisen. |
| PKEY_Sensor_Power_Milliwatts | VT_R4 | R/O | Optional | Die Sensorleistung, ausgedrückt in Milliwatt. |
| PKEY_SensorHistory_MaxSize_Bytes | VT_UI4 | R/O | Optional Aber erforderlich, wenn der Sensor den Verlauf unterstützt. |
Die maximale Größe von Sensorverlaufsdaten, ausgedrückt in Byte. |
| PKEY_SensorHistory_Interval_Ms | VT_UI4 | R/O | Optional Aber erforderlich, wenn der Sensor den Verlauf unterstützt. |
Das Sensorverlaufs-Samplingintervall, ausgedrückt in Millisekunden. |
| PKEY_SensorHistory_MaximumRecordSize_Bytes | VT_UI4 | R/O | Optional Aber erforderlich, wenn der Sensor den Verlauf unterstützt. |
Die maximale Datensatzgröße, ausgedrückt in Byte. |
| PKEY_Sensor_FifoReservedSize_Samples | VT_UI4 | R/O | Optional Aber erforderlich, wenn der Sensor die Batchverarbeitung unterstützt. |
Die Anzahl der Ereignisse, die für diesen Sensor im FIFO-Puffer (First-in-First-out) für den Batch reserviert sind. Dies garantiert eine Mindestanzahl von Ereignissen. Wenn dieser Wert null ist, gibt es keine Garantie dafür, dass der Sensor die Batchverarbeitung durchführt. |
| PKEY_Sensor_FifoMaxSize_Samples | VT_UI4 | R/O | Optional Aber erforderlich, wenn der Sensor die Batchverarbeitung unterstützt. |
Die maximale Anzahl von Ereignissen, die im FIFO gebündelt werden können. Wenn dieser Wert null ist, wird die Batchverarbeitung vom Sensor nicht unterstützt. Die tatsächliche Anzahl der Ereignisse kann kleiner als diese Zahl sein, da das Batch-FIFO von mehreren Sensoren gemeinsam genutzt werden kann. |
| PKEY_Sensor_WakeCapable | VT_BOOL | R/O | Optional Aber erforderlich, wenn der Sensor die Batchverarbeitung unterstützt. |
Gibt an, ob der Sensor reaktiviert werden kann. Wenn ein Sensor die Sensor-Batchverarbeitung unterstützt, sollte diese Eigenschaft auf VARIANT_TRUE gesetzt werden, wenn der Sensor den Anwendungsprozessor bei vollem FIFO reaktivieren kann. Und der Wert sollte auf VARIANT_FALSE festgelegt werden, wenn der Sensor den Anwendungsprozessor nicht reaktivieren kann. In diesem Fall gibt der Zustand dieser Eigenschaft die Fähigkeit des Sensors an, aus dem verbundenen Standbymodus zu reaktivieren. Wenn der Sensor das Reaktivieren eines Systems von SX unterstützt, sollte diese Eigenschaft auf VARIANT_TRUE festgelegt werden. Wenn die Aktivierung von SX nicht unterstützt wird, sollte diese Eigenschaft auf VARIANT_FALSE festgelegt werden. |
Datenbatchverarbeitung
Ein Sensortreiber, der die Datenbatchverarbeitung unterstützt, muss die folgenden allgemeinen Sensoreigenschaften melden:
- PKEY_Sensor_FifoReservedSize_Samples
- PKEY_Sensor_FifoMaxSize_Samples
- PKEY_Sensor_WakeCapable
Ab Windows 10, Version 1511, steht jetzt Unterstützung für die Implementierung der Datenbatchverarbeitung mithilfe des HID-Sensorklassentreibers zur Verfügung. Weitere Informationen hierzu finden Sie unter Steuerelemente für Sensorbatchverarbeitung.
Informationen zur Rückruffunktion im Zusammenhang mit der Datenbatchverarbeitung finden Sie unter EvtSensorSetBatchLatency.
Aufgrund der Fähigkeit eines Sensors, die CPU und das Betriebssystem aus dem SX-Zustand zu reaktivieren, wird PKEY_Sensor_WakeCapable auch als Aufzählungseigenschaft verwendet, die aus dem PnP-Treiberspeicher abgefragt werden kann, um herauszufinden, ob der Sensor das System nicht nur aus dem verbundenen Standby, sondern auch aus dem SX-Zustand reaktivieren kann.
Hinweise
Wenn der Clienttreiber die folgenden Eigenschaften meldet, muss der Clienttreiber CollectionsListGetMarshalledSizeWithoutSerialization anstelle von CollectionsListGetMarshalledSize verwenden:
- PKEY_SensorHistory_MaxSize_Bytes
- PKEY_SensorHistory_MaximumRecordSize_Bytes