CustomSensor.ReportInterval Propriété

Définition

Espace de noms:

Windows.Devices.Sensors.Custom

Obtient ou définit l’intervalle de rapport actuel pour le capteur.

public:
 property unsigned int ReportInterval { unsigned int get(); void set(unsigned int value); };

uint32_t ReportInterval();

void ReportInterval(uint32_t value);

public uint ReportInterval { get; set; }

var uInt32 = customSensor.reportInterval;
customSensor.reportInterval = uInt32;

Public Property ReportInterval As UInteger

Valeur de propriété

UInt32

unsigned int

uint32_t

Intervalle de rapport actuel pour le capteur.

Remarques

L’intervalle de rapport est spécifié en millisecondes.

L’intervalle de rapport est défini sur une valeur par défaut qui varie en fonction de l’implémentation du pilote de capteur. Si votre application ne souhaite pas utiliser cette valeur par défaut, définissez l’intervalle de rapport sur une valeur différente de zéro avant d’inscrire un gestionnaire d’événements ou d’appeler GetCurrentReading. Le capteur tente ensuite d’allouer des ressources pour répondre aux exigences de l’application, mais il doit également équilibrer les besoins des autres applications utilisant le capteur.

Les modifications apportées à l’intervalle de rapport après l’inscription d’un gestionnaire d’événements ou l’appel de GetCurrentReading peuvent s’appliquer à la remise des lectures de capteur suivantes.

À l’inverse, lorsqu’une application a fini d’utiliser le capteur, nous vous recommandons de renvoyer explicitement le capteur à son intervalle de rapport par défaut en lui affectant la valeur zéro. Cela est important pour la conservation de l’énergie, en particulier lors de l’utilisation d’un langage qui peut maintenir l’objet capteur actif pendant une période indéfinie avant le garbage collection.

Nous vous recommandons de consulter la propriété MinimumReportInterval avant de définir l’intervalle de rapport pour vous assurer que le capteur peut respecter l’intervalle de rapport demandé. La définition d’une valeur inférieure à l’intervalle minimum pris en charge déclenche une exception ou génère des résultats non définis.

Bien que l’application puisse définir cette valeur pour demander un intervalle de rapport particulier, le pilote détermine l’intervalle de rapport réel, en fonction de la logique interne. Par exemple, le pilote peut utiliser l’intervalle de rapport le plus court demandé par n’importe quel appelant.

La définition d’une valeur zéro demande au pilote d’utiliser son intervalle de rapport par défaut. Comme avec la demande d’un intervalle spécifique, le pilote peut choisir un intervalle différent en fonction d’autres demandes clientes et de la logique interne.

La plateforme de capteurs personnalisés définit automatiquement la sensibilité aux modifications pour les capteurs personnalisés en fonction de l’intervalle de rapport actuel. Ce tableau spécifie les valeurs de sensibilité de modification pour des intervalles donnés.

Intervalle de rapport actuel (spécifié en millisecondes)	Modifier la sensibilité (spécifiée en tant que force G)
1 ms – 16 ms	0,01 G
17 ms – 32 ms	0,02 G
>= 33 ms	0,05 G