流管理

枚举系统中的音频终结点设备并确定合适的呈现或捕获设备后，音频客户端应用程序的下一个任务是打开与终结点设备的连接，并管理通过该连接传输的音频数据流。 WASAPI 使客户端能够创建和管理音频流。

WASAPI 实现多个接口，为音频客户端提供流管理服务。 主接口为 IAudioClient。 客户端通过对终结点对象调用 IMMDevice::Activate 方法（参数 iid设置为 REFIID IID_IAudioClient）来获取音频终结点设备的 IAudioClient 接口。

客户端在 IAudioClient 接口中调用方法执行以下操作：

• 发现终结点设备支持的音频格式。
• 获取终结点缓冲区大小。
• 获取流格式和延迟。
• 启动、停止和重置流经终结点设备的流。
• 访问其他音频服务。

若要创建流，客户端调用 IAudioClient::Initialize 方法。 通过此方法，客户端指定流的数据格式、终结点缓冲区的大小以及流是以共享模式还是独占模式运行。

IAudioClient 接口中的剩余方法分为两组：

• 仅在 IAudioClient::Initialize 打开流后才能调用的方法。
• 可在 Initialize 调用之前或之后随时调用的方法。

只有在调用 IAudioClient::Initialize 后才能调用以下方法：

• IAudioClient::GetBufferSize
• IAudioClient::GetCurrentPadding
• IAudioClient::GetService
• IAudioClient::GetStreamLatency
• IAudioClient::Reset
• IAudioClient::Start
• IAudioClient::Stop

在 IAudioClient::Initialize 调用之前或之后可以调用以下方法：

• IAudioClient::GetDevicePeriod
• IAudioClient::GetMixFormat
• IAudioClient::IsFormatSupported

若要访问其他音频客户端服务，客户端调用 IAudioClient::GetService 方法。 通过此方法，客户端可以获取对以下接口的引用：

• IAudioRenderClient

  将呈现数据写入音频呈现终结点缓冲区。

• IAudioCaptureClient

  从音频捕获终结点缓冲区读取捕获的数据。

• IAudioSessionControl

  与音频会话管理器通信，以配置和管理与流关联的音频会话。

• ISimpleAudioVolume

  控制与流关联的音频会话的音量。

• IChannelAudioVolume

  控制音频会话中与流关联的各个通道的音量。

• IAudioClock

  监视流数据速率和流位置。

此外，需要会话相关事件通知的 WASAPI 客户端应实现以下接口：

• IAudioSessionEvents

  若要接收事件通知，客户端会将指向其 IAudioSessionEvents 接口的指针作为调用参数传递给 IAudioSessionControl::RegisterAudioSessionNotification 方法。

最后，客户端可能使用更高级别的 API 创建音频流，但也需要访问包含流的会话的会话控件和音量控件。 较高级别的 API 通常不提供此访问权限。 客户端可以通过 IAudioSessionManager 接口获取特定会话的控件。 此接口使客户端能够获取会话的 IAudioSessionControl 和 ISimpleAudioVolume 接口，而无需客户端使用 IAudioClient 接口创建流并将流分配给会话。 客户端通过对终结点对象调用 IMMDevice::Activate 方法（参数 iid设置为 REFIID IID_IAudioSessionManager）来获取音频终结点设备的 IAudioSessionManager 接口。

IAudioSessionControl、IAudioSessionEvents 和 IAudioSessionManager 接口在头文件 Audiopolicy.h 中定义。 所有其他 WASAPI 接口都在头文件 Audioclient.h 中定义。

以下部分介绍如何使用 WASAPI 管理音频流：

• 关于 WASAPI
• 呈现流
• 捕获流
• 环回录制
• 独占模式流
• 从无效设备错误中恢复
• 使用通信设备
• 流路由

相关主题

编程指南