Oggetto Report dei dati del sensore

Importante

Usare invece l'API sensore UWP .

L'API del sensore basata su COM è deprecata e non deve essere usata nelle nuove applicazioni. Non sono pianificate funzionalità o miglioramenti aggiuntivi e il supporto sarà limitato.

L'oggetto del report dei dati del sensore contiene i dati del sensore.

Affinché un sensore sia utile, deve fornire dati significativi. La quantità e la frequenza di generazione dei dati variano da sensore a sensore. Ad esempio, un sensore che rileva se una porta è aperta genera una piccola quantità di dati booleani, mentre un sensore di movimento potrebbe generare continuamente più elementi di dati. Per standardizzare il modo in cui il programma riceve i dati, l'API Sensor usa l'oggetto report dei dati del sensore.

È possibile accedere alle informazioni in un report dei dati del sensore tramite l'interfacciaISensorDataReport. Questa interfaccia consente di recuperare il timestamp del report dati in modo da determinare se le informazioni nel report sono utili. È possibile recuperare i dati stessi in due modi: come valore singolo del campo dati o come set di valori. Per recuperare i dati come singolo valore, chiamare il metodoGetSensorValue. Per recuperare più valori, chiamare il metodoGetSensorValues.

Si specifica il tipo di dati, o i campi dati, che si desidera recuperare dal report utilizzando una costante PROPERTYKEY. Le chiavi delle proprietà per i campi dati dei tipi di sensori comuni sono definite in Sensors.h.