IAudioSessionManager：：GetSimpleAudioVolume 方法 (audiopolicy.h)

  • 项目

GetSimpleAudioVolume 方法检索简单的音量控件。

语法

HRESULT GetSimpleAudioVolume(
  [in]  LPCGUID            AudioSessionGuid,
  [in]  DWORD              StreamFlags,
  [out] ISimpleAudioVolume **AudioVolume
);

参数

[in] AudioSessionGuid

指向会话 GUID 的指针。 如果 GUID 未标识以前打开的会话，则调用将打开一个新的但为空的会话。 Sndvol 程序不显示会话的音量级控件，除非它包含一个或多个活动流。 如果此参数为 NULL 或指向值GUID_NULL，则该方法会将流分配给默认会话。

[in] StreamFlags

指定请求是否用于跨进程会话。 如果会话是跨进程，则设置为 TRUE 。 如果会话不是跨进程，则设置为 FALSE 。

[out] AudioVolume

指向指针变量的指针，该方法在其中写入指向音频音量控制对象的 ISimpleAudioVolume 接口的指针。 此接口表示当前进程的简单音频音量控制。 调用方负责通过调用接口的 Release 方法，在不再需要接口时释放接口。 如果 Activate 调用失败， 则 *AudioVolume 为 NULL。

返回值

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

返回代码 说明
AUDCLNT_E_NOT_INITIALIZED
 音频流尚未成功初始化。
AUDCLNT_E_DEVICE_INVALIDATED
 音频终结点设备已拔出，或者音频硬件或关联的硬件资源已重新配置、禁用、删除或以其他方式不可用。
AUDCLNT_E_SERVICE_NOT_RUNNING
 Windows 音频服务未运行。
E_POINTER
 参数 AudioVolume 为 NULL。
E_MEMORY
 内存不足。

要求

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

另请参阅

IAudioSessionManager 接口

ISimpleAudioVolume 接口