CustomSensor.ReportInterval Propiedad

Definición

Espacio de nombres:

Windows.Devices.Sensors.Custom

Obtiene o establece el intervalo de informe actual para el sensor.

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

Valor de propiedad

UInt32

unsigned int

uint32_t

Intervalo de informe actual para el sensor.

Comentarios

El intervalo del informe se especifica en milisegundos.

El intervalo de informe se establecerá en un valor predeterminado que variará en función de la implementación del controlador del sensor. Si la aplicación no quiere usar este valor predeterminado, establezca 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 intentará asignar recursos para satisfacer los requisitos de la aplicación, pero el sensor también tiene que equilibrar las necesidades de otras aplicaciones que usan el sensor.

Los cambios realizados 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, se recomienda que devuelva explícitamente el sensor a su intervalo de informe predeterminado estableciendolo en cero. Esto es importante para la conservación de energía, especialmente cuando se usa un lenguaje que puede mantener activo el objeto sensor durante un período indefinido antes de la recolección de elementos no utilizados.

Se recomienda que la aplicación consulte la propiedad MinimumReportInterval antes de establecer el intervalo de informe para asegurarse de que el sensor pueda respetar el intervalo de informe solicitado. Si se establece un valor por debajo del intervalo mínimo admitido, se desencadenará una excepción o se producirán resultados no definidos.

Aunque la aplicación puede establecer este valor para solicitar un intervalo de informe determinado, el controlador determinará 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.

Establecer un valor de cero solicita al controlador que use 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 personalizado establece automáticamente la sensibilidad de cambio para los sensores personalizados 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 (especificado en milisegundos)	Cambiar la sensibilidad (especificada como fuerza G)
1 ms – 16 ms	0,01 G
17 ms – 32 ms	0,02 G
>= 33 ms	0,05 G