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