Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Important
Utilisez plutôt l’API de capteur UWP .
L’API de capteur COM est déconseillée et ne doit pas être utilisée dans les nouvelles applications. Aucune fonctionnalité ou amélioration supplémentaire n’est planifiée et la prise en charge sera limitée.
L’objet de rapport de données du capteur contient des données de capteur.
Pour qu’un capteur soit utile, il doit fournir des données significatives. La quantité et la fréquence de génération de données varient du capteur au capteur. Par exemple, un capteur qui détecte si une porte est ouverte génère une petite quantité de données booléennes , tandis qu’un capteur de mouvement peut générer en continu plusieurs éléments de données. Pour normaliser la façon dont votre programme reçoit des données, l’API Sensor utilise l’objet de rapport de données de capteur.
Vous pouvez accéder aux informations d’un rapport de données de capteur via l’interface ISensorDataReport . Cette interface vous permet de récupérer l’horodatage du rapport de données afin de déterminer si les informations contenues dans le rapport sont utiles. Vous pouvez récupérer les données elles-mêmes de deux manières : en tant que valeur de champ de données individuelle ou en tant qu’ensemble de valeurs. Pour récupérer des données en tant que valeur individuelle, appelez la méthode GetSensorValue . Pour récupérer plusieurs valeurs, appelez la méthode GetSensorValues .
Vous spécifiez le type de données ou les champs de données que vous souhaitez récupérer à partir du rapport à l’aide d’une constante PROPERTYKEY . Les clés de propriété pour les champs de données des types de capteurs courants sont définies dans Sensors.h.