Magnetometer.ReportInterval Propriedade

Definição

Namespace:

Windows.Devices.Sensors

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

UInt32

unsigned int

uint32_t

O intervalo de relatório atual, em milissegundos.

Comentários

O intervalo de relatório é definido como um valor padrão que varia 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 tenta alocar recursos para atender aos requisitos do aplicativo, equilibrando 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, ele deve retornar 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.

O aplicativo deve consultar 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 dispara uma exceção ou tem resultados indefinidos.

Embora o aplicativo possa definir esse valor para solicitar um intervalo de relatório específico, o driver determina 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.

Se o valor for definido como zero, o driver usará 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 lógica interna.

A plataforma de sensor define automaticamente a sensibilidade de alteração para magnetômetros 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	Alterar sensibilidade
1 ms – 16 ms	0,01 graus
17 ms – 32 ms	0,5 graus
>= 33 ms	2 graus