Propiedades de sensores comunes
En este artículo se describen las propiedades del sensor que son comunes para todos los sensores.
En la tabla siguiente se muestran las propiedades comunes. Para obtener más información sobre los tipos que se muestran en la columna de tipo, consulte la estructura PROPVARIANT.
| Clave de propiedad | Tipo | Acceso (R/O, R/W) | Obligatorio/opcional | Descripción |
|---|---|---|---|---|
| PKEY_Sensor_Type | VT_CLSID | R/O | Obligatorio | Tipo de sensor. El GUID consta del mismo formato que un sensor de Windows (por ejemplo, SENSOR_TYPE_ACCELEROMETER_3D). Para obtener más información sobre los tipos de sensor, consulte GUID de tipo de sensor. |
| PKEY_Sensor_State | VT_UI4 | R/O | Obligatorio | Estado del sensor. Para obtener más información sobre los estados del sensor, consulte SENSOR_STATE. |
| PKEY_Sensor_MinimumDataInterval_Ms | VT_UI4 | R/O | Obligatorio | Intervalo de tiempo mínimo (en milisegundos) que admite el hardware para la generación de informes de datos del sensor. |
| PKEY_Sensor_MaximumDataFieldSize_Bytes | VT_UI4 | R/O | Obligatorio | Tamaño máximo devuelto en una llamada ReadFile. Una llamada a ReadFile permite que la API nativa asigne un búfer para contener cualquier campo de datos. |
| PKEY_Sensor_Power_Milliwatts | VT_R4 | R/O | Opcionales | Potencia del sensor expresada en milivatios. |
| PKEY_SensorHistory_MaxSize_Bytes | VT_UI4 | R/O | Opcional , pero obligatorio, si el sensor admite el historial. |
Tamaño máximo de los datos del historial de sensores, expresados en bytes. |
| PKEY_SensorHistory_Interval_Ms | VT_UI4 | R/O | Opcional , pero obligatorio, si el sensor admite el historial. |
Intervalo de muestreo del historial del sensor, expresado en milisegundos. |
| PKEY_SensorHistory_MaximumRecordSize_Bytes | VT_UI4 | R/O | Opcional , pero obligatorio, si el sensor admite el historial. |
Tamaño máximo del registro expresado en bytes. |
| PKEY_Sensor_FifoReservedSize_Samples | VT_UI4 | R/O | Opcional , pero obligatorio, si el sensor admite el procesamiento por lotes. |
Número de eventos reservados para este sensor en el búfer de "primero en entrar, primero en salir" (FIFO) para el lote. Esto garantiza un número mínimo de eventos. Si este valor es cero, no hay ninguna garantía de que el sensor realice el procesamiento por lotes. |
| PKEY_Sensor_FifoMaxSize_Samples | VT_UI4 | R/O | Opcional , pero obligatorio, si el sensor admite el procesamiento por lotes. |
Número máximo de eventos que se pueden procesar por lotes en FIFO. Si este valor es cero, el sensor no admite el procesamiento por lotes. El número real de eventos puede ser menor que este número, ya que varios sensores pueden compartir el FIFO por lotes. |
| PKEY_Sensor_WakeCapable | VT_BOOL | R/O | Opcional , pero obligatorio, si el sensor admite el procesamiento por lotes. |
Indica si el sensor es compatible con la reactivación. Cuando un sensor admite el procesamiento por lotes de sensor, esta propiedad debe establecerse en VARIANT_TRUE, si el sensor puede reactivar el procesador de aplicaciones cuando el FIFO está lleno. Y el valor debe establecerse en VARIANT_FALSE, si el sensor no puede reactivar el procesador de aplicaciones. En este caso, el estado de esta propiedad indica la capacidad del sensor de reactivarse desde el modo en espera conectado. Si el sensor admite la reactivación de un sistema desde SX, esta propiedad debe establecerse en VARIANT_TRUE y, si no admite la reactivación desde SX, esta propiedad debe establecerse en VARIANT_FALSE. |
Procesamiento de datos por lotes
Un controlador de sensor que admita el procesamiento de datos por lotes debe notificar las siguientes propiedades comunes del sensor:
- PKEY_Sensor_FifoReservedSize_Samples
- PKEY_Sensor_FifoMaxSize_Samples
- PKEY_Sensor_WakeCapable
A partir de Windows 10, versión 1511, la compatibilidad ahora está disponible para implementar el procesamiento de datos por lotes mediante el controlador de clase de sensor HID. Para obtener más información, consulte Controles de procesamiento por lotes del sensor.
Consulte EvtSensorSetBatchLatency para obtener información sobre la función de devolución de llamada relacionada con el procesamiento de datos por lotes.
Con la capacidad de un sensor para reactivar la CPU y el sistema operativo desde el estado SX, PKEY_Sensor_WakeCapable también se usa como una propiedad de enumeración que se puede consultar desde el almacén del controlador PnP para averiguar si el sensor es capaz de reactivar el sistema desde SX además de reactivarlo desde el modo en espera conectado.
Comentarios
Cuando el controlador cliente informa de las siguientes propiedades, debe usar CollectionsListGetMarshalledSizeWithoutSerialization en lugar de CollectionsListGetMarshalledSize:
- PKEY_SensorHistory_MaxSize_Bytes
- PKEY_SensorHistory_MaximumRecordSize_Bytes