共用方式為

IAudioSessionManager：：GetAudioSessionControl 方法 (audiopolicy.h)

  • 發行項

GetAudioSessionControl方法會擷取音訊會話控制項。

語法

HRESULT GetAudioSessionControl(
  [in]  LPCGUID              AudioSessionGuid,
  [in]  DWORD                StreamFlags,
  [out] IAudioSessionControl **SessionControl
);

參數

[in] AudioSessionGuid

會話 GUID 的指標。 如果 GUID 未識別先前開啟的會話，則呼叫會開啟新的但空白的會話。 除非會話包含一或多個作用中的資料流程，否則 Sndvol 程式不會顯示會話的磁片區層級控制項。 如果此參數為 Null 或指向值GUID_Null，方法會將資料流程指派給預設會話。

[in] StreamFlags

指定音訊資料流程旗標的狀態。

[out] SessionControl

指標變數的指標，方法會將指標寫入音訊會話控制項物件的 IAudioSessionControl 介面。 呼叫端會藉由呼叫介面的 Release 方法，負責釋放不再需要的介面。 如果呼叫失敗， *SessionControl 為 Null。

傳回值

如果方法成功，它會傳回 S_OK。 如果失敗，可能的傳回碼包括但不限於下表所示的值。

傳回碼 Description
AUDCLNT_E_NOT_INITIALIZED
 音訊資料流程尚未成功初始化。
AUDCLNT_E_DEVICE_INVALIDATED
 音訊端點裝置已解除叢集，或音訊硬體或相關聯的硬體資源已重新設定、停用、移除或無法使用。
AUDCLNT_E_SERVICE_NOT_RUNNING
 Windows 音訊服務未執行。
E_POINTER
 參數 SessionControl 為 Null。
E_MEMORY
 記憶體不足。

備註

如需呼叫此方法的程式碼範例，請參閱 舊版音訊應用程式的音訊事件。

規格需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 audiopolicy.h

另請參閱

IAudioSessionControl 介面

IAudioSessionManager 介面