Accelerometer.ReportInterval Propriedade

Definição

Namespace:

Windows.Devices.Sensors

Obtém ou define o intervalo de relatório atual para o acelerô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 = accelerometer.reportInterval;
accelerometer.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.