_AM_AUDIO_RENDERER_STAT_PARAM 枚举 (strmif.h)

[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayerIMFMediaEngine媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayerIMFMediaEngineMedia Foundation 中的音频/视频捕获 ,而不是 DirectShow。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

_AM_AUDIO_RENDERER_STAT_PARAM枚举指定要从音频呈现器检索的性能信息。

此枚举类型用于 IAMAudioRendererStats::GetStatParam 方法。 每个枚举成员定义 GetStatParampdwParam1pdwParam2 参数中返回的值的含义。

注意

无偏见的通信 Microsoft 支持多样化和包容性的环境。 本文档中引用了“slave”一词。 Microsoft 的 《Bias-Free 通信风格指南 》将此视为排除词。 使用此措辞,因为它是软件中当前使用的措辞。 为保持一致,本文档包含此单词。 当从软件中删除此单词时,我们将更正此文档以保持对齐。

语法

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) 筛选器将速率与主时钟匹配时适用。
AM_AUDREND_STAT_PARAM_SLAVE_HIGHLOWERROR
Param1:音频呈现器时钟与其尝试匹配的时钟之间记录的最大差异。

Param2:音频呈现器时钟与它尝试匹配的时钟之间记录的最小差异。

仅当音频呈现器将速率与主时钟匹配时有效。
AM_AUDREND_STAT_PARAM_SLAVE_LASTHIGHLOWERROR
Param1:最后一个高错误(以毫秒为单位)。 当音频呈现器落后于时钟时,会发生 高错误

Param2:最后一个低误差(以毫秒为单位)。 当音频呈现器在时钟之前运行时,会出现 低错误

仅当音频呈现器将速率与主时钟匹配时有效。
AM_AUDREND_STAT_PARAM_SLAVE_ACCUMERROR
Param1:音频呈现器和主时钟之间的累积差异,包括通过删除样本或插入间隙进行的调整。

Param2:未使用。

仅当音频呈现器将速率与另一个时钟或实时源匹配时有效。
AM_AUDREND_STAT_PARAM_BUFFERFULLNESS
Param1:音频缓冲区中的音频数据量(以百分比表示)。

Param2:未使用。
AM_AUDREND_STAT_PARAM_JITTER
未实现。

要求

要求
Header strmif.h (包括 Dshow.h)

另请参阅

DirectShow 枚举类型

IAMAudioRendererStats 接口