Compartir a través de

Propiedades comunes del sensor

  • Artículo

En este tema 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, vea Estructura PROPVARIANT.

Clave de propiedad Tipo Acceso (R/O, R/W) Obligatorio/opcional Descripción
PKEY_Sensor_Type VT_CLSID R/O Requerido Tipo de sensor. El GUID constará 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 Requerido 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 Requerido 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 Requerido Tamaño máximo devuelto en una llamada ReadFile. Una llamada ReadFile permite a la API nativa asignar un búfer para contener cualquier campo de datos.
PKEY_Sensor_Power_Milliwatts VT_R4 R/O Opcionales Potencia del sensor expresada en miliwatts.
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 necesario, si el sensor admite el procesamiento por lotes.		 El número de eventos reservados para este sensor en el búfer fist-in-first-out (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 necesario, 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 necesario, si el sensor admite el procesamiento por lotes.		 Indica si el sensor es capaz de reactivar.

Cuando un sensor admite el procesamiento por lotes del sensor, se debe establecer en VARIANT_TRUE, si el sensor puede reactivar el procesador de la aplicación cuando el FIFO está lleno. Y el valor debe establecerse en VARIANT_FALSE, si el sensor no puede reactivar el procesador de la aplicación. Cuando este es el caso, el estado de esta propiedad indica la capacidad del sensor de reactivarse desde el modo de 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 por lotes de datos

Un controlador de sensor que admita el procesamiento por lotes de datos 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 por lotes de datos mediante el controlador de clase de sensor HID. Para obtener información sobre esto, 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 por lotes de datos.

Con la capacidad adicional 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 despertar el sistema desde SX además de despertar el sistema desde el modo de espera conectado.

Comentarios

Cuando el controlador cliente informa de las siguientes propiedades, el controlador de cliente debe usar CollectionsListGetMarshalledSizeWithoutSerialization en lugar de CollectionsListGetMarshalledSize:

  • PKEY_SensorHistory_MaxSize_Bytes
  • PKEY_SensorHistory_MaximumRecordSize_Bytes