Gyrometer.ReportInterval Свойство

Определение

Пространство имен:

Windows.Devices.Sensors

Возвращает или задает текущий интервал отчета для гирометра.

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

Public Property ReportInterval As UInteger

Значение свойства

UInt32

unsigned int

uint32_t

Текущий интервал отчета в миллисекундах.

Комментарии

Интервал отчета имеет значение по умолчанию, которое зависит от реализации драйвера датчика. Если приложение не хочет использовать это значение по умолчанию, необходимо задать для интервала отчета ненулевое значение перед регистрацией обработчика событий или вызовом Метода GetCurrentReading. Затем датчик пытается выделить ресурсы для удовлетворения требований приложения, балансируя потребности других приложений с помощью датчика.

Изменения интервала отчета после регистрации обработчика событий или вызова GetCurrentReading могут применяться к доставке последующих показаний датчика.

И наоборот, когда приложение завершает работу с датчиком, оно должно явно вернуть датчик к интервалу отчета по умолчанию, установив для него нулевое значение. Это важно для экономии электроэнергии, особенно при использовании языка, который может поддерживать активный объект датчика в течение неопределенного периода до сборки мусора.

Приложение должно обратиться к свойству MinimumReportInterval перед настройкой интервала отчета, чтобы убедиться, что датчик может учитывать запрошенный интервал отчета. Установка значения ниже минимального поддерживаемого интервала либо вызывает исключение, либо приводит к неопределенным результатам.

Хотя приложение может задать это значение для запроса определенного интервала отчета, драйвер определяет фактический интервал отчета на основе внутренней логики. Например, драйвер может использовать кратчайший интервал отчета, запрашиваемый любым вызывающим абонентом.

Если значение равно нулю, драйвер использует интервал отчета по умолчанию. Как и при запросе определенного интервала, драйвер может выбрать другой интервал в зависимости от других клиентских запросов и внутренней логики.

Платформа датчика автоматически задает чувствительность изменения для гирометров на основе текущего интервала отчета. В этой таблице указаны значения конфиденциальности изменений для заданных интервалов.

Текущий интервал отчета	Изменение чувствительности (градусов в секунду)
От 1 мс до 16 мс	0.1 DPS
от 17 мс до 32 мс	0.5 DPS
>= 33 мс	1.0 DPS

См. также раздел

• MinimumReportInterval