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。 如果失败,可能的返回代码包括但不限于下表中显示的值。
返回代码 | 说明 |
---|---|
|
音频流尚未成功初始化。 |
|
音频终结点设备已拔出,或者音频硬件或关联的硬件资源已重新配置、禁用、删除或以其他方式不可用。 |
|
Windows 音频服务未运行。 |
|
参数 AudioVolume 为 NULL。 |
|
内存不足。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | audiopolicy.h |