IAudioSessionControl2：：GetSessionInstanceIdentifier 方法 (audiopolicy.h)

  • 项目

GetSessionInstanceIdentifier 方法检索音频会话实例的标识符。

语法

HRESULT GetSessionInstanceIdentifier(
  [out] LPWSTR *pRetVal
);

参数

[out] pRetVal

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

返回值

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

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

注解

每个音频会话实例由唯一字符串标识。 此字符串表示音频会话的特定实例，与会话标识符不同，在所有实例中都是唯一的。 如果有两个应用程序实例正在播放，它们将具有不同的会话实例标识符。 GetSessionInstanceIdentifier 检索的标识符不同于所有会话实例共享的会话标识符。 若要获取会话标识符，请调用 IAudioSessionControl2：：GetSessionIdentifier。

GetSessionInstanceIdentifier 检查会话是否已在默认设备上断开连接。 它检索由设备的音频客户端缓存的标识符字符串。 如果未找到会话实例标识符，此方法将从音频引擎中检索它。 有关获取会话实例标识符的示例代码，请参阅 从通信设备获取躲避事件。

要求

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

另请参阅

IAudioSessionControl2

使用通信设备