Перечисление _AM_AUDIO_RENDERER_STAT_PARAM (strmif.h)

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]

Перечисление _AM_AUDIO_RENDERER_STAT_PARAM указывает, какие сведения о производительности следует извлечь из отрисовщика звука.

Этот тип перечисления используется в методе IAMAudioRendererStats::GetStatParam . Каждый элемент перечисления определяет значение значений, возвращаемых в параметрах pdwParam1 и pdwParam2объекта GetStatParam.

Примечание

Связь без предубеждений Майкрософт поддерживает разнообразную и инклюзивную среду. В этом документе есть ссылки на слово "slave". Руководство майкрософт по стилю для Bias-Free Communications распознает это как исключаемое слово. Эта формулировка используется, так как в настоящее время это формулировка, используемая в программном обеспечении. Для согласованности этот документ содержит это слово. Когда это слово будет удалено из программного обеспечения, мы исправим этот документ, чтобы он был в выравнивании.

Синтаксис

typedef enum _AM_AUDIO_RENDERER_STAT_PARAM {
  AM_AUDREND_STAT_PARAM_BREAK_COUNT = 1,
  AM_AUDREND_STAT_PARAM_SLAVE_MODE,
  AM_AUDREND_STAT_PARAM_SILENCE_DUR,
  AM_AUDREND_STAT_PARAM_LAST_BUFFER_DUR,
  AM_AUDREND_STAT_PARAM_DISCONTINUITIES,
  AM_AUDREND_STAT_PARAM_SLAVE_RATE,
  AM_AUDREND_STAT_PARAM_SLAVE_DROPWRITE_DUR,
  AM_AUDREND_STAT_PARAM_SLAVE_HIGHLOWERROR,
  AM_AUDREND_STAT_PARAM_SLAVE_LASTHIGHLOWERROR,
  AM_AUDREND_STAT_PARAM_SLAVE_ACCUMERROR,
  AM_AUDREND_STAT_PARAM_BUFFERFULLNESS,
  AM_AUDREND_STAT_PARAM_JITTER
} ;

Константы

 
AM_AUDREND_STAT_PARAM_BREAK_COUNT
Значение: 1
Param1: совокупное количество перерывов в звуковом потоке.

Param2: не используется.
AM_AUDREND_STAT_PARAM_SLAVE_MODE
Param1: указывает текущий режим сопоставления скорости. Значение представляет собой побитовое сочетание следующего:


  • 0x00: не соответствует скорости.

  • 0x01: сопоставление ставок с динамическим источником.

  • 0x02: частота совпадений на основе скорости входящих звуковых данных.

  • 0x04: скорость сопоставления с эталонными часами графа фильтра (если часы не предоставляются отрисовщиком звука).

  • 0x10: коэффициент соответствия на основе меток времени в примерах аудио.


Param2: не используется.
AM_AUDREND_STAT_PARAM_SILENCE_DUR
Param1: совокупное количество тишины, вставленной отрисовщиком звука, из-за пробелов в метках времени входящих выборок. Значение задается в миллисекундах.

Param2: не используется.
AM_AUDREND_STAT_PARAM_LAST_BUFFER_DUR
Param1: длительность последнего звукового буфера в миллисекундах.

Param2: не используется.
AM_AUDREND_STAT_PARAM_DISCONTINUITIES
Param1: совокупное количество разрывов в аудиопотоке.

Param2: не используется.
AM_AUDREND_STAT_PARAM_SLAVE_RATE
Param1: частота выборки, которая соответствует отрисовщику звука, в выборках в секунду.

Param2: не используется.

Допустимо только в том случае , если отрисовщик DirectSound сопоставляет тарифы с другими часами или динамическим источником.
AM_AUDREND_STAT_PARAM_SLAVE_DROPWRITE_DUR
Param1: объем данных, отброшенных для синхронизации, в миллисекундах.

Param2: не используется.

Применяется, только если фильтр Отрисовщик звука (WaveOut) соответствует скорости master часам.
AM_AUDREND_STAT_PARAM_SLAVE_HIGHLOWERROR
Param1: самая высокая разница между часами отрисовщика звука и часами, которые он пытается сопоставить.

Param2: самая низкая разница между часами отрисовщика звука и часами, которые он пытается сопоставить.

Допустимо только в том случае, если отрисовщик звука соответствует скорости master часам.
AM_AUDREND_STAT_PARAM_SLAVE_LASTHIGHLOWERROR
Param1: последняя высокая ошибка в миллисекундах. Высокая ошибка возникает, когда отрисовщик звука отстает от часов.

Param2: последняя низкая ошибка в миллисекундах. Низкая ошибка возникает, когда отрисовщик звука работает впереди часов.

Допустимо только в том случае, если отрисовщик звука соответствует скорости master часам.
AM_AUDREND_STAT_PARAM_SLAVE_ACCUMERROR
Param1: накопленные различия между отрисовщиком звука и master часами, включая корректировки, внесенные путем удаления выборок или вставки пробелов.

Param2: не используется.

Допустимо только в том случае, если отрисовщик звука соответствует скорости другим часам или источнику трансляции.
AM_AUDREND_STAT_PARAM_BUFFERFULLNESS
Param1: сколько звуковых данных находится в звуковом буфере в процентах.

Param2: не используется.
AM_AUDREND_STAT_PARAM_JITTER
Не реализован.

Требования

Требование Значение
Заголовок strmif.h (включая Dshow.h)

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

Перечислимые типы DirectShow

Интерфейс IAMAudioRendererStats