IAudioSessionManager2::GetSessionEnumerator 方法 (audiopolicy.h)
GetSessionEnumerator 方法获取指向音频会话枚举器对象的指针。
语法
HRESULT GetSessionEnumerator(
[out] IAudioSessionEnumerator **SessionEnum
);
参数
[out] SessionEnum
接收指向会话枚举器对象的 IAudioSessionEnumerator 接口的指针,客户端可以使用该接口枚举音频设备上的音频会话。 通过此方法,调用方获取对 接口的计数引用。 调用方负责通过调用接口的 Release 方法,在不再需要接口时释放接口。
返回值
如果该方法成功,则它会返回 S_OK。
注解
会话管理器通过查询音频引擎来维护音频设备上处于活动状态的音频会话集合。 GetSessionEnumerator 为集合中的每个会话创建会话控件。 若要获取对枚举集合中会话的 IAudioSessionControl 接口的引用,应用程序必须调用 IAudioSessionEnumerator::GetSession。 有关代码示例,请参阅 IAudioSessionEnumerator 接口。
会话枚举器可能不知道通过 IAudioSessionNotification 报告的新会话。 因此,如果应用程序完全依赖于会话枚举器来获取音频终结点的所有会话,则结果可能不准确。 若要解决此问题,应用程序应手动维护列表。 有关详细信息,请参阅 IAudioSessionEnumerator。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 7 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
目标平台 | Windows |
标头 | audiopolicy.h |