Compartilhar via


O objeto de relatório de dados do sensor

Importante

Em vez disso, use a Sensor API UWP.

A API de Sensor baseada em COM foi preterida e não deve ser usada em novos aplicativos. Nenhum recurso ou aprimoramento adicional é planejado e o suporte será limitado.

O objeto de relatório de dados do sensor contém dados do sensor.

Para que um sensor seja útil, ele deve fornecer dados significativos. A quantidade e a frequência da geração de dados variam de sensor para sensor. Por exemplo, um sensor que detecta se uma porta está aberta geraria uma pequena quantidade de dados boolianos , enquanto um sensor de movimento pode gerar continuamente vários itens de dados. Para padronizar a maneira como seu programa recebe dados, a API do Sensor usa o objeto de relatório de dados do sensor.

Você pode acessar as informações em um relatório de dados do sensor por meio da interface ISensorDataReport . Essa interface permite recuperar o carimbo de data/hora do relatório de dados para que você possa determinar se as informações no relatório são úteis. Você pode recuperar os dados em si de duas maneiras: como um valor de campo de dados individual ou como um conjunto de valores. Para recuperar dados como um valor individual, chame o método GetSensorValue . Para recuperar vários valores, chame o método GetSensorValues .

Especifique o tipo de dados ou campos de dados que deseja recuperar do relatório usando uma constante PROPERTYKEY . As chaves de propriedade para campos de dados de tipos de sensor comuns são definidas em Sensors.h.