KSPROPERTY_RTAUDIO_PRESENTATION_POSITION
KSPROPERTY_RTAUDIO_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 |