Propiedades del sensor
La plataforma Sensor y Location define constantes que identifican las propiedades de los sensores. Los fabricantes de sensores también pueden definir sus propias propiedades.
La plataforma define los siguientes valores PROPERTYKEY para las propiedades del sensor. Estas propiedades son de solo lectura a menos que se indique lo contrario.
Cada propiedad de sensor definida por la plataforma PROPERTYKEY se basa en un GUID común denominado SENSOR_PROPERTY_COMMON_GUID:
{7F8383EC-D3EC-495C-A8CF-B8BBE85C2920}.
Importante
No use este valor base para definir sus propias claves de propiedad.
La aplicación cliente puede especificar los valores de las propiedades designadas como lectura y escritura. Los valores de las propiedades designadas como estáticas no deben cambiar con el tiempo. El sensor debe admitir las propiedades designadas como necesarias.
| Nombre de clave de propiedad y PID | Descripción |
|---|---|
|
VT_UNKNOWN Solo lectura. Objeto IPortableDeviceValues que contiene nombres de tipo de datos del sensor y sus precisiónes asociadas. Los valores de precisión representan la posible variación de los valores true. Los valores de precisión se expresan mediante las mismas unidades que el campo de datos, excepto cuando se documentan de otro modo. |
|
VT_UNKNOWN Lectura/escritura Objeto IPortableDeviceValues que contiene nombres de tipo de datos del sensor y sus valores de confidencialidad de cambio asociados. Los valores de confidencialidad modificados proporcionan solicitudes sobre la cantidad por la que el campo de datos debe cambiar antes de que se genere el evento de SENSOR_EVENT_DATA_UPDATED. Los valores de confidencialidad se expresan mediante las mismas unidades que el campo de datos, excepto cuando se documentan de otro modo. Para algunos sensores, la sensibilidad del cambio se interpreta como un valor real. Por ejemplo, un valor de sensibilidad de cambio de 2 para SENSOR_DATA_TYPE_TEMPERATURE_CELSIUS representa una sensibilidad de más o menos 2 grados Celsius. Para otros sensores, como el sensor de luz ambiente (ALS), la sensibilidad de cambio se interpreta como un porcentaje. Por lo tanto, una sensibilidad de cambio de 2 para SENSOR_DATA_TYPE_LIGHT_LEVEL_LUX representa más o menos el 2 % de LUX. Puede establecer este valor para solicitar una sensibilidad de cambio determinada, pero varias aplicaciones podrían usar el mismo sensor. Por lo tanto, los sensores determinan la verdadera sensibilidad del cambio, en función de su lógica interna. Por ejemplo, el sensor siempre podría usar la sensibilidad de cambio más pequeña solicitada por cualquiera de las aplicaciones. Si una aplicación establece esta propiedad en VT_NULL, el controlador de dispositivo restablecerá SENSOR_PROPERTY_CHANGE_SENSITIVITY a su valor predeterminado. |
|
VT_UI4 Solo lectura. Valor sensorConnectionType que contiene el tipo de conexión actual. |
|
VT_UI4 Lectura/escritura Tiempo transcurrido actual para la generación de informes de datos del sensor, en milisegundos. Establecer un valor de cero indica al controlador que use su intervalo de informe predeterminado. Después de recibir un valor de cero para esta propiedad, un controlador debe devolver su intervalo de informe predeterminado, no cero, cuando se consulta. Las aplicaciones pueden establecer este valor para solicitar un intervalo de informe determinado, pero varias aplicaciones podrían usar el mismo controlador. Por lo tanto, los controladores determinan el intervalo de informe verdadero, en función de la lógica interna. Por ejemplo, el controlador siempre puede usar el intervalo de informe más corto solicitado por cualquier llamador. Para obtener un ejemplo de cómo usar esta propiedad, consulte Uso de eventos de SENSOR API. |
|
VT_LPWSTR Solo lectura. Cadena de descripción del sensor. |
|
VT_LPWSTR Solo lectura. Identifica de forma única la instancia del dispositivo con la que está asociado el sensor. Puede usar esta propiedad para determinar si un dispositivo contiene varios sensores. Los controladores de dispositivo no tienen que admitir esta propiedad porque la plataforma proporciona este valor a las aplicaciones sin consultar controladores. |
|
VT_LPWSTR Solo lectura. Obligatorio, estático. Nombre descriptivo del dispositivo. |
|
VT_UI4 Solo lectura. Esta propiedad se proporciona para que los fabricantes de sensores HID y los desarrolladores de controladores tengan un medio para identificar un sensor que se muestre en la capa de API con un nombre descriptivo de "desconocido". |
|
VT_VECTOR| VT_UI1 Solo lectura. Matriz con recuento que contiene pares de valores que proporcionan una asignación entre los niveles de luz ambiente y los desplazamientos. Estos valores se expresan como porcentajes. La característica de brillo adaptable en Windows aplica estos valores a la preferencia actual del brillo de la pantalla del usuario. Los datos de los tipos vectoriales siempre se serializan como VT_UI1 (una matriz de caracteres sin signo y de 1 byte). Esta propiedad contiene realmente cada valor como un entero sin signo (VT_UI4) de 4 bytes. Para obtener información sobre cómo trabajar con matrices, vea Recuperación de tipos de vectores. |
|
VT_UI4 Lectura/escritura Valor de la enumeración LOCATION_DESIRED_ACCURACY que indica el tipo de control de precisión solicitado por una aplicación cliente. LOCATION_DESIRED_ACCURACY_DEFAULT (0) indica que el sensor debe usar la precisión para la que puede optimizar el uso de energía y otras consideraciones de costos. LOCATION_DESIRED_ACCURACY_HIGH (1) indica que el sensor debe entregar el informe más preciso posible. Para ello, pueden usarse servicios que no son gratuitos o aumentar el consumo de energía de la batería o del ancho de banda de la conexión. |
|
VT_LPWSTR Solo lectura. Obligatorio, estático. Nombre del fabricante. |
|
VT_UI4 Solo lectura. Obligatorio, estático. Intervalo mínimo que admite el hardware para la generación de informes de datos del sensor, en milisegundos. |
|
VT_LPWSTR Solo lectura. Obligatorio, estático. Nombre del modelo del sensor. |
|
VT_CLSID Solo lectura. Obligatorio, estático. GUID que identifica el sensor. Este valor debe ser único para cada sensor de un dispositivo o en todos los dispositivos del mismo modelo que se enumeran en el equipo. Esta propiedad contiene el mismo valor obtenido llamando a ISensor::GetID . |
|
VT_UKNOWN Solo lectura. Objeto IPortableDeviceValues que contiene nombres de campo de datos del sensor y sus valores máximos asociados. |
|
VT_UKNOWN Solo lectura. Objeto IPortableDeviceValues que contiene nombres de campo de datos del sensor y sus valores mínimos asociados. |
|
VT_UKNOWN Solo lectura. Objeto IPortableDeviceValues que contiene nombres de campo de datos del sensor y sus resoluciones asociadas. Los valores de resolución representan la confidencialidad para cambiar en el campo de datos. Los valores de resolución se expresan utilizando las mismas unidades que el campo de datos, excepto cuando se documentan de otro modo. |
|
VT_LPWSTR Solo lectura. Obligatorio, estático. Número de serie del sensor. |
|
VT_UI4 Solo lectura. Necesario. Valor sensorState que contiene el estado del sensor actual. |
|
VT_CLSID Solo lectura. Obligatorio, estático. GUID que identifica el tipo de sensor. Los tipos de sensor definidos por la plataforma se definen en Sensors.h. |
Todos los sensores deben admitir la siguiente propiedad dispositivos portátiles (WPD) de Windows.
| Clave de propiedad | Descripción |
|---|---|
|
VT_CLSID Solo lectura. Obligatorio, estático. Define la categoría del sensor. |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
No se admite ninguno |
| Encabezado |
|
Consulte también