IAudioEndpointVolume：：SetChannelVolumeLevel 方法 (endpointvolume.h)

项目
02/26/2024

SetChannelVolumeLevel 方法设置进入或离开音频终结点设备的音频流的指定声道的音量级别（以分贝为单位）。

语法

HRESULT SetChannelVolumeLevel(
  [in] UINT    nChannel,
  [in] float   fLevelDB,
  [in] LPCGUID pguidEventContext
);

参数

[in] nChannel

通道号。如果音频流包含 n 个通道，则通道的编号从 0 到 n – 1。若要获取通道数，请调用 IAudioEndpointVolume：：GetChannelCount 方法。

[in] fLevelDB

以分贝为单位的新音量级别。若要获取可通过此方法设置的卷级别的范围和粒度，请调用 IAudioEndpointVolume：：GetVolumeRange 方法。

[in] pguidEventContext

IAudioEndpointVolumeCallback：：OnNotify 方法的上下文值。此参数指向事件上下文 GUID。如果 SetChannelVolumeLevel 调用更改终结点的卷级别，则已注册具有该终结点的 IAudioEndpointVolumeCallback 接口的所有客户端都将收到通知。在 OnNotify 方法的实现中，客户端可以检查事件上下文 GUID，以发现它是还是另一个客户端是卷更改事件的源。如果调用方为此参数提供 NULL 指针，则通知例程将接收上下文 GUID 值GUID_NULL。

返回值

如果该方法成功，则它会返回 S_OK。如果方法失败，可能的返回代码包括但不限于下表中显示的值。

返回代码	说明
E_INVALIDARG	参数 nChannel 大于或等于流中的通道数;或参数 fLevelDB 位于设备支持的卷范围之外。
E_OUTOFMEMORY	内存不足。

注解

如果卷级别 fLevelDB 超出 IAudioEndpointVolume：：GetVolumeRange 方法报告的音量范围， SetChannelVolumeLevel 调用将失败，并返回错误代码E_INVALIDARG。

要求

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