CustomSensor.ReportInterval Propriedade

Definição

Namespace:

Windows.Devices.Sensors.Custom

Obtém ou define o intervalo de relatório atual para o 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 da propriedade

UInt32

unsigned int

uint32_t

O intervalo de relatório atual para o sensor.

Comentários

O intervalo de relatório é especificado em milissegundos.

O intervalo de relatório será definido como um valor padrão que variará de acordo com a implementação do driver do sensor. Se o aplicativo não quiser usar esse valor padrão, defina o intervalo de relatório como um valor diferente de zero antes de registrar um manipulador de eventos ou chamar GetCurrentReading. Em seguida, o sensor tentará alocar recursos para atender aos requisitos do aplicativo, mas o sensor também precisa equilibrar as necessidades de outros aplicativos usando o sensor.

As alterações no intervalo de relatório depois que um manipulador de eventos tiver sido registrado ou GetCurrentReading tiver sido chamado podem se aplicar à entrega de leituras subsequentes do sensor.

Por outro lado, quando um aplicativo é concluído com o sensor, recomendamos que ele retorne explicitamente o sensor para seu intervalo de relatório padrão definindo-o como zero. Isso é importante para a conservação de energia, especialmente ao usar uma linguagem que pode manter o objeto sensor ativo por um período indefinido antes da coleta de lixo.

Recomendamos que o aplicativo consulte a propriedade MinimumReportInterval antes de definir o intervalo de relatório para garantir que o sensor possa respeitar o intervalo de relatório solicitado. Definir um valor abaixo do intervalo mínimo com suporte disparará uma exceção ou terá resultados indefinidos.

Embora o aplicativo possa definir esse valor para solicitar um intervalo de relatório específico, o driver determinará o intervalo de relatório real, com base na lógica interna. Por exemplo, o driver pode usar o intervalo de relatório mais curto solicitado por qualquer chamador.

Definir um valor de zero solicita que o driver use seu intervalo de relatório padrão. Assim como ocorre com a solicitação de um intervalo específico, o driver pode escolher um intervalo diferente com base em outras solicitações de cliente e na lógica interna.

A plataforma de sensor personalizada define automaticamente a confidencialidade de alteração para sensores personalizados com base no intervalo de relatório atual. Esta tabela especifica os valores de confidencialidade de alteração para determinados intervalos.

Intervalo de relatório atual (especificado em milissegundos)	Alterar a confidencialidade (especificada como força G)
1 ms – 16 ms	0,01 G
17 ms – 32 ms	0,02 G
>= 33 ms	0,05 G