Altimeter.ReportInterval Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit l’intervalle de rapport actuel pour l’altimètre.
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 = altimeter.reportInterval;
altimeter.reportInterval = uInt32;
Public Property ReportInterval As UInteger
Valeur de propriété
Intervalle de rapport actuel, en millisecondes.
Remarques
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, vous devez définir 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 tout en équilibrant les besoins d’autres applications à l’aide du 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 terminé le capteur, elle doit explicitement renvoyer le capteur à son intervalle de rapport par défaut en le définissant sur zéro. Cela est important pour la conservation de l’alimentation, 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.
L’application doit consulter la propriété MinimumReportInterval avant de définir l’intervalle de rapport pour s’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 a 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.
Si la valeur est définie sur zéro, le pilote utilise son intervalle de rapport par défaut. Comme avec la demande d’un intervalle spécifique, le pilote peut choisir un autre intervalle en fonction d’autres demandes clientes et de la logique interne.