KSPROPERTY_AUDIO_POSITION

项目
02/23/2024

KSPROPERTY_AUDIO_POSITION 属性指定播放的当前位置，并将光标写入固定音频流的声音缓冲区中。

使用情况摘要表

获取	设置	目标	属性描述符类型	属性值类型
是	是	固定	KSPROPERTY	KSAUDIO_POSITION

属性值（操作数据）是一种类型为 KSAUDIO_POSITION 的结构，用于指定呈现流的播放和写入位置或捕获流的记录和读取位置。

返回值

KSPROPERTY_AUDIO_POSITION 属性请求返回 STATUS_SUCCESS，以指示它已成功完成。否则，请求将返回适当的错误状态代码。

注解

DirectSound 使用 KSPROPERTY_AUDIO_POSITION 属性来实现 IDirectSoundBuffer::GetCurrentPosition 和 IDirectSoundBuffer::SetCurrentPosition 方法。 Windows 多媒体函数 waveInGetPosition 和 waveOutGetPosition 也使用此属性。有关 DirectSound 和 Windows 多媒体函数的详细信息，请参阅 Microsoft Windows SDK 文档。

WaveCyclic 和 WavePci 微型端口驱动程序不需要为 KSPROPERTY_AUDIO_POSITION 实现属性处理程序，因为 WaveCyclic 和 WavePci 端口驱动程序代表微型端口驱动程序处理此属性。若要获取捕获流中呈现流或记录位置中的播放位置，端口驱动程序中的属性处理程序调用微型端口驱动程序的 IMiniportWaveCyclicStream::GetPosition 或 IMiniportWavePciStream::GetPosition 方法。

有关详细信息，请参阅音频位置属性。