IAudioRenderClient 接口 (audioclient.h)

IAudioRenderClient 接口使客户端能够将输出数据写入呈现终结点缓冲区。 客户端通过调用 IAudioClient::GetService 方法获取对流对象的 IAudioRenderClient 接口的引用,并将参数 riid 设置为 REFIID IID_IAudioRenderClient。

此接口中的方法管理包含音频呈现数据的数据包的移动。 数据包的长度表示为数据包中的音频帧数。 音频帧的大小由客户端通过调用 IAudioClient::GetMixFormat 方法获取的 WAVEFORMATEX 结构的 nBlockAlign 成员指定。 音频帧的大小(以字节为单位)等于流中的通道数乘以每个通道的样本大小。 例如,包含 16 位样本的立体声 (2 声道) 流的帧大小为 4 个字节。 数据包始终包含整数数量的音频帧。

释放 IAudioRenderClient 接口实例时,客户端必须从创建对象的 IAudioClient::GetService 调用的同一线程调用接口的 Release 方法。

有关使用 IAudioRenderClient 接口的代码示例,请参阅以下主题:

继承

IAudioRenderClient 接口继承自 IUnknown 接口。 IAudioRenderClient 还具有以下类型的成员:

方法

IAudioRenderClient 接口具有以下方法。

 
IAudioRenderClient::GetBuffer

检索指向呈现终结点缓冲区中下一个可用空间的指针,调用方可以在其中写入数据包。
IAudioRenderClient::ReleaseBuffer

ReleaseBuffer 方法释放在上次调用 IAudioRenderClient::GetBuffer 方法时获取的缓冲区空间。

要求

要求
最低受支持的客户端 Windows Vista [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2008 [桌面应用 | UWP 应用]
目标平台 Windows
标头 audioclient.h

另请参阅

核心音频接口

IAudioClient::GetMixFormat

IAudioClient::GetService

WASAPI