通过

IAudioSessionControl2：：GetSessionIdentifier 方法 (audiopolicy.h)

  • 项目

GetSessionIdentifier 方法检索音频会话标识符。

语法

HRESULT GetSessionIdentifier(
  [out] LPWSTR *pRetVal
);

参数

[out] pRetVal

指向接收音频会话标识符的以 null 结尾的宽字符字符串的地址的指针。 字符串由此方法分配，必须由调用方通过调用 CoTaskMemFree 释放。 有关 CoTaskMemFree 的信息，请参阅 Windows SDK 文档。

返回值

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

返回值 说明
E_POINTER
 pRetVal 为 NULL。
AUDCLNT_E_DEVICE_INVALIDATED
 音频会话在默认音频设备上断开连接。

注解

每个音频会话都由标识符字符串标识。 此会话标识符字符串并非在所有实例中是唯一的。 如果应用程序有两个实例正在播放，则两个实例将具有相同的会话标识符。 GetSessionIdentifier 检索的标识符不同于会话实例标识符，该标识符在所有会话中都是唯一的。 若要获取会话实例标识符，请调用 IAudioSessionControl2：：GetSessionInstanceIdentifier。

GetSessionIdentifier 检查会话是否已在默认设备上断开连接。 它检索音频客户端为设备缓存的标识符字符串。 如果找不到会话标识符，此方法将从音频引擎中检索它。

要求

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

另请参阅

IAudioSessionControl2