Magnetometer.ReportInterval Propiedad

Definición

Espacio de nombres:

Windows.Devices.Sensors

Obtiene o establece el intervalo de informe actual para el magnetómetro.

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 = magnetometer.reportInterval;
magnetometer.reportInterval = uInt32;

Public Property ReportInterval As UInteger

Valor de propiedad

UInt32

unsigned int

uint32_t

Intervalo de informe actual, en milisegundos.

Comentarios

El intervalo de informe se establece en un valor predeterminado que varía en función de la implementación del controlador del sensor. Si la aplicación no quiere usar este valor predeterminado, debe establecer el intervalo de informe en un valor distinto de cero antes de registrar un controlador de eventos o llamar a GetCurrentReading. A continuación, el sensor intenta asignar recursos para satisfacer los requisitos de la aplicación, a la vez que equilibra las necesidades de otras aplicaciones mediante el sensor.

Los cambios en el intervalo de informe después de que se haya registrado un controlador de eventos o de que se haya llamado a GetCurrentReading se pueden aplicar a la entrega de lecturas posteriores del sensor.

Por el contrario, cuando una aplicación finaliza con el sensor, debe devolver explícitamente el sensor a su intervalo de informe predeterminado estableciendo en cero. Esto es importante para la conservación de energía, especialmente cuando se usa un lenguaje que podría mantener activo el objeto sensor durante un período indefinido antes de la recolección de elementos no utilizados.

La aplicación debe consultar la propiedad MinimumReportInterval antes de establecer el intervalo de informe para asegurarse de que el sensor pueda respetar el intervalo de informe solicitado. Establecer un valor por debajo del intervalo mínimo admitido desencadena una excepción o tiene resultados indefinidos.

Aunque la aplicación puede establecer este valor para solicitar un intervalo de informe determinado, el controlador determina el intervalo de informe real, en función de la lógica interna. Por ejemplo, el controlador puede usar el intervalo de informe más corto solicitado por cualquier autor de llamada.

Si el valor se establece en cero, el controlador usa su intervalo de informe predeterminado. Al igual que con la solicitud de un intervalo específico, el controlador puede elegir un intervalo diferente en función de otras solicitudes de cliente y lógica interna.

La plataforma del sensor establece automáticamente la sensibilidad de cambio para los magnetómetros en función del intervalo de informe actual. En esta tabla se especifican los valores de confidencialidad de cambio para intervalos determinados.

Intervalo de informe actual	Cambiar la confidencialidad
1 ms – 16 ms	0,01 grados
17 ms – 32 ms	0,5 grados
>= 33 ms	2 grados