IAudioSessionControl::GetGroupingParam 方法 (audiopolicy.h)

GetGroupingParam 方法检索音频会话的分组参数。

语法

HRESULT GetGroupingParam(
  [out] GUID *pRetVal
);

参数

[out] pRetVal

分组参数 GUID 的输出指针。 此参数必须是指向调用方分配的 GUID 变量的有效非 NULL 指针。 方法将分组参数写入此变量。

返回值

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

返回代码 说明
E_POINTER
参数 pRetValNULL
AUDCLNT_E_DEVICE_INVALIDATED
音频终结点设备已拔出,或者音频硬件或关联的硬件资源已重新配置、禁用、删除或以其他方式不可用。
AUDCLNT_E_SERVICE_NOT_RUNNING
Windows 音频服务未运行。

注解

具有相同分组参数值的所有音频会话都受系统音量控制程序 Sndvol 中相同音量级别滑块的控制。 有关详细信息,请参阅 分组参数

客户端可以调用 IAudioSessionControl::SetGroupingParam 方法来更改会话的分组参数。

如果客户端从未调用 SetGroupingParam 将分组参数分配给音频会话,则默认情况下将GUID_NULL会话的分组参数值,并且调用 GetGroupingParam 会检索此值。 GUID_NULL的分组参数值指示会话不属于任何分组。 在这种情况下,会话在 Sndvol 程序中有自己的卷级滑块。

要求

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

另请参阅

IAudioSessionControl 接口

IAudioSessionControl::SetGroupingParam