Propriedades do sensor
A plataforma Sensor e Location define constantes que identificam propriedades para sensores. Os fabricantes de sensores também podem definir suas próprias propriedades.
A plataforma define os seguintes valores PROPERTYKEY para propriedades do sensor. Essas propriedades são somente leitura, a menos que indicado de outra forma.
Cada propriedade de sensor definida pela plataforma PROPERTYKEY baseia-se em um GUID comum chamado SENSOR_PROPERTY_COMMON_GUID:
{7F8383EC-D3EC-495C-A8CF-B8BBE85C2920}.
Importante
Não use esse valor base para definir suas próprias chaves de propriedade.
Os valores das propriedades designadas como leitura/gravação podem ser especificados pelo aplicativo cliente. Os valores das propriedades designadas como estáticas não devem ser alterados ao longo do tempo. As propriedades designadas como necessárias devem ser compatíveis com o sensor.
| Nome da chave de propriedade e PID | Descrição |
|---|---|
|
VT_UNKNOWN Somente leitura. Objeto IPortableDeviceValues que contém nomes de tipo de dados do sensor e suas precisões associadas. Os valores de precisão representam uma possível variação dos valores verdadeiros. Os valores de precisão são expressos usando as mesmas unidades que o campo de dados, exceto quando documentados de outra forma. |
|
VT_UNKNOWN Leitura/gravação. Objeto IPortableDeviceValues que contém nomes de tipo de dados do sensor e seus valores de confidencialidade de alteração associados. Os valores de confidencialidade de alteração fornecem solicitações sobre o valor pelo qual o campo de dados deve ser alterado antes que o evento SENSOR_EVENT_DATA_UPDATED seja acionado. Os valores de confidencialidade são expressos usando as mesmas unidades que o campo de dados, exceto quando documentado de outra forma. Para alguns sensores, a confidencialidade da alteração é interpretada como um valor real. Por exemplo, um valor de confidencialidade de alteração de 2 para SENSOR_DATA_TYPE_TEMPERATURE_CELSIUS representa uma sensibilidade de mais ou menos 2 graus Celsius. Para outros sensores, como o ALS (sensor de luz ambiente), a sensibilidade de alteração é interpretada como uma porcentagem. Portanto, uma sensibilidade de alteração de 2 para SENSOR_DATA_TYPE_LIGHT_LEVEL_LUX representa mais ou menos 2% de LUX. Você pode definir esse valor para solicitar uma confidencialidade de alteração específica, mas vários aplicativos podem estar usando o mesmo sensor. Portanto, os sensores determinam a verdadeira confidencialidade de alteração, com base em sua lógica interna. Por exemplo, o sensor sempre pode usar a menor confidencialidade de alteração solicitada por qualquer um dos aplicativos. Se um aplicativo definir essa propriedade como VT_NULL, o driver do dispositivo redefinirá SENSOR_PROPERTY_CHANGE_SENSITIVITY para seu valor padrão. |
|
VT_UI4 Somente leitura. Valor SensorConnectionType que contém o tipo de conexão atual. |
|
VT_UI4 Leitura/gravação. O tempo decorrido atual para a geração de relatórios de dados do sensor, em milissegundos. Definir um valor de zero sinaliza que o driver use seu intervalo de relatório padrão. Depois de receber um valor zero para essa propriedade, um driver deve retornar seu intervalo de relatório padrão, não zero, quando consultado. Os aplicativos podem definir esse valor para solicitar um intervalo de relatório específico, mas vários aplicativos podem estar usando o mesmo driver. Portanto, os drivers determinam o intervalo de relatório verdadeiro, com base na lógica interna. Por exemplo, o driver sempre pode usar o intervalo de relatório mais curto solicitado por qualquer chamador. Para obter um exemplo de como usar essa propriedade, consulte Usando eventos de API do sensor. |
|
VT_LPWSTR Somente leitura. A cadeia de caracteres de descrição do sensor. |
|
VT_LPWSTR Somente leitura. Identifica exclusivamente a instância do dispositivo à qual o sensor está associado. Você pode usar essa propriedade para determinar se um dispositivo contém vários sensores. Os drivers de dispositivo não precisam dar suporte a essa propriedade porque a plataforma fornece esse valor para aplicativos sem consultar drivers. |
|
VT_LPWSTR Somente leitura. Obrigatório, estático. O nome amigável para o dispositivo. |
|
VT_UI4 Somente leitura. Essa propriedade é fornecida para que os fabricantes de sensores HID e os desenvolvedores de driver tenham um meio de identificar um sensor que aparece na camada de API com um nome amigável de "desconhecido". |
|
VT_VECTOR| VT_UI1 Somente leitura. Uma matriz contada que contém pares de valores que fornecem um mapeamento entre níveis de luz ambiente e deslocamentos. Esses valores são expressos como percentuais. O recurso de brilho adaptável no Windows aplica esses valores à preferência de brilho de exibição atual do usuário. Os dados para tipos de vetor são sempre serializados como VT_UI1 (uma matriz de caracteres sem sinal de 1 byte). Na verdade, essa propriedade contém cada valor como um inteiro sem sinal de 4 bytes (VT_UI4). Para obter informações sobre como trabalhar com matrizes, consulte Recuperando tipos de vetor. |
|
VT_UI4 Leitura/gravação. Um valor da enumeração LOCATION_DESIRED_ACCURACY que indica o tipo de tratamento de precisão solicitado por um aplicativo cliente. LOCATION_DESIRED_ACCURACY_DEFAULT (0) indica que o sensor deve usar a precisão para a qual pode otimizar o uso de energia e outras considerações de custo. LOCATION_DESIRED_ACCURACY_HIGH (1) indica que o sensor deve fornecer o relatório mais preciso possível. Isso inclui usar serviços que podem cobrar dinheiro ou consumir níveis mais altos de energia da bateria ou largura de banda da conexão. |
|
VT_LPWSTR Somente leitura. Obrigatório, estático. O nome do fabricante. |
|
VT_UI4 Somente leitura. Obrigatório, estático. O intervalo mínimo ao qual o hardware dá suporte para a geração de relatórios de dados do sensor, em milissegundos. |
|
VT_LPWSTR Somente leitura. Obrigatório, estático. O nome do modelo do sensor. |
|
VT_CLSID Somente leitura. Obrigatório, estático. Um GUID que identifica o sensor. Esse valor deve ser exclusivo para cada sensor em um dispositivo ou entre dispositivos do mesmo modelo que enumerados no computador. Essa propriedade contém o mesmo valor obtido chamando ISensor::GetID . |
|
VT_UKNOWN Somente leitura. Objeto IPortableDeviceValues que contém nomes de campo de dados do sensor e seus valores máximos associados. |
|
VT_UKNOWN Somente leitura. Objeto IPortableDeviceValues que contém nomes de campo de dados do sensor e seus valores mínimos associados. |
|
VT_UKNOWN Somente leitura. Objeto IPortableDeviceValues que contém nomes de campo de dados do sensor e suas resoluções associadas. Os valores de resolução representam a sensibilidade à alteração no campo de dados. Os valores de resolução são expressos usando as mesmas unidades que o campo de dados, exceto quando documentado de outra forma. |
|
VT_LPWSTR Somente leitura. Obrigatório, estático. O número de série do sensor. |
|
VT_UI4 Somente leitura. Obrigatórios. Valor sensorState que contém o estado atual do sensor. |
|
VT_CLSID Somente leitura. Obrigatório, estático. Um GUID que identifica o tipo de sensor. Os tipos de sensor definidos pela plataforma são definidos em Sensors.h. |
A propriedade WPD (Dispositivos Portáteis do Windows) a seguir deve ter suporte de todos os sensores.
| Chave de propriedade | Descrição |
|---|---|
|
VT_CLSID Somente leitura. Obrigatório, estático. Define a categoria do sensor. |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Nenhum compatível |
| Cabeçalho |
|
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de