通过

KSPROPERTY_RTAUDIO_PRESENTATION_POSITION

  • 项目

KSPROPERTY_RTAUDIO_PRESENTATION_POSITION 返回流呈现信息。

使用情况摘要表

获取 设置 目标 属性描述符类型 属性值类型

是

否

固定

KSPROPERTY

KSAUDIO_PRESENTATION_POSITION

属性描述符（实例数据）是 KSPROPERTY 结构。 在发送请求之前，客户端加载具有描述音频数据流中当前光标位置的值的结构。

属性值是 KSAUDIO_PRESENTATION_POSITION 结构，表示音频数据流中最近的呈现位置。

返回值

KSPROPERTY_RTAUDIO_PRESENTATION_POSITION 属性请求返回 STATUS_SUCCESS，以指示已成功完成。 否则，请求将返回适当的故障状态代码。

注解

操作系统周期性地从驱动程序获得该属性，以从驱动程序检索最近的呈现位置信息，以便允许上层将视频或其他活动与音频流同步。

在 KSAUDIO_PRESENTATION_POSITION 的 u64PositionInBlocks 成员中返回的值应与 KSPROPERTY_RTAUDIO_PACKETCOUN 返回的数据包计数以及驱动程序对传递给 SetWritePacket 的数据包编号的解释一致。 换句话说，数据包 0 的第一个样本是块 0。

这并不意味着如果同时调用 KSPROPERTY_RTAUDIO_PACKETCOUNT 和 KSPROPERTY_RTAUDIO_PRESENTATION_POSITION，则会返回引用同一示例的值。 KSPROPERTY_RTAUDIO_PACKETCOUNT 返回有关从 WaveRT 缓冲区传输到硬件的样本的信息，而 KSPROPERTY_RTAUDIO_PRESENTATION_POSITION 返回有关在系统输出处呈现的样本的相关信息。 这是两条不同的信息。

要求

版本

适用于 Windows 10 及更高版本的 Windows 操作系统。

标头

 Ksmedia.h

另请参阅

KSPROPSETID_RTAudio