共用方式為

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

使用通訊裝置