Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Importante
Em vez disso, use a API do sensor UWP .
A API do sensor baseada em COM foi preterida e não deve ser usada em novos aplicativos. Não estão planeados quaisquer recursos ou melhorias adicionais e o suporte será limitado.
A plataforma Sensor e Localização 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 as propriedades do sensor. Essas propriedades são somente leitura, salvo indicação em contrário.
Cada propriedade de sensor definida pela plataforma PROPERTYKEY é baseada 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 para propriedades designadas como leitura/gravação podem ser especificados pelo aplicativo cliente. Os valores das propriedades designadas como estáticas não devem mudar ao longo do tempo. As propriedades designadas como necessárias devem ser suportadas pelo sensor.
| Nome da chave de propriedade e PID | Description |
|---|---|
|
VT_UNKNOWN Somente leitura. IPortableDeviceValues objeto que contém nomes de tipo de dados do sensor e suas precisões associadas. Os valores de precisão representam a possível variação dos valores reais. Os valores de precisão são expressos utilizando as mesmas unidades que o campo de dados, salvo quando documentados de outra forma. |
|
VT_UNKNOWN Leitura/gravação. IPortableDeviceValues objeto que contém nomes de tipo de dados do sensor e seus valores de sensibilidade de alteração associados. Os valores de sensibilidade de alteração fornecem solicitações sobre a quantidade pela qual o campo de dados deve ser alterado antes que o evento SENSOR_EVENT_DATA_UPDATED seja gerado. Os valores de sensibilidade são expressos utilizando as mesmas unidades que o campo de dados, salvo documentação em contrário. Para alguns sensores, a sensibilidade à mudança é interpretada como um valor real. Por exemplo, um valor de sensibilidade à alteração de 2 para SENSOR_DATA_TYPE_TEMPERATURE_CELSIUS representa uma sensibilidade de 2 graus Celsius para mais ou para menos. Para outros sensores, como o sensor de luz ambiente (ALS), a sensibilidade à mudança é interpretada como uma percentagem. Assim, uma sensibilidade à 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 sensibilidade de alteração específica, mas vários aplicativos podem estar usando o mesmo sensor. Portanto, os sensores determinam a verdadeira sensibilidade à mudança, com base em sua lógica interna. Por exemplo, o sensor pode sempre usar a menor sensibilidade de alteração solicitada por qualquer um dos aplicativos. Se um aplicativo definir essa propriedade como VT_NULL, o driver de 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 atual decorrido para a geração de relatórios de dados do sensor, em milissegundos. Definir um valor zero sinaliza o driver para usar seu intervalo de relatório padrão. Depois de receber um valor de 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 oferecer 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. Esta propriedade é fornecida para que os fabricantes de sensores HID e desenvolvedores de drivers tenham um meio de identificar um sensor que aparece na camada de API com um nome amigável de "desconhecido". |
|
VT_VETOR|VT_UI1 Somente leitura. Uma matriz contada que contém pares de valores que fornecem um mapeamento entre os níveis de luz ambiente e os deslocamentos. Estes valores são expressos em percentagem. O recurso de brilho adaptável no Windows aplica esses valores à preferência atual de brilho da tela do usuário. Os dados para tipos de vetor são sempre serializados como VT_UI1 (uma matriz de caracteres não assinados de 1 byte). Na verdade, essa propriedade contém cada valor como um inteiro não assinado 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 manipulação de precisão solicitada por um aplicativo cliente. LOCATION_DESIRED_ACCURACY_DEFAULT (0) indica que o sensor deve usar a precisão para a qual ele 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 o uso de serviços que podem cobrar dinheiro ou o consumo de 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 que o hardware suporta 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, conforme enumerado no computador. Esta propriedade contém o mesmo valor obtido chamando ISensor::GetID . |
|
VT_UKNOWN Somente leitura. IPortableDeviceValues objeto que contém nomes de campo de dados do sensor e seus valores máximos associados. |
|
VT_UKNOWN Somente leitura. IPortableDeviceValues objeto que contém nomes de campo de dados do sensor e seus valores mínimos associados. |
|
VT_UKNOWN Somente leitura. IPortableDeviceValues objeto 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. Required. 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 sensores definidos pela plataforma são definidos em Sensors.h. |
A seguinte propriedade Windows Portable Devices (WPD) deve ser suportada por todos os sensores.
| Chave da propriedade | Description |
|---|---|
|
VT_CLSID Somente leitura. Obrigatório, estático. Define a categoria do sensor. |
Requerimentos
| Requisito | Valor |
|---|---|
| Cliente mínimo suportado |
Windows 7 [apenas aplicações de ambiente de trabalho] |
| Servidor mínimo suportado |
Nenhum suportado |
| Header |
|