IAudioSessionEvents::OnStateChanged 方法 (audiopolicy.h)
OnStateChanged 方法會通知用戶端會話的數據流活動狀態已變更。
語法
HRESULT OnStateChanged(
[in] AudioSessionState NewState
);
參數
[in] NewState
新的工作階段狀態。 此參數的值是下列其中一個 AudioSessionState 列舉值:
AudioSessionStateActive
AudioSessionStateInactive
AudioSessionStateExpired
傳回值
如果方法成功,它會傳回 S_OK。 如果方法失敗,則會傳回錯誤碼。
備註
用戶端無法產生工作階段狀態變更事件。 系統一律是這種類型的事件來源。 因此,不同於其他一些 IAudioSessionEvents 方法,此方法不提供內容參數。
系統會在用戶端在會話中開啟第一個數據流時,將會話的狀態從非作用中變更為作用中。 用戶端會呼叫 IAudioClient::Initialize 方法來開啟數據流。 系統會在用戶端關閉會話的最後一個數據流時,將會話狀態從作用中變更為非作用中。 釋放 IAudioClient 對象最後一個參考的用戶端會關閉與 對象相關聯的數據流。
如需實作 IAudioSessionEvents 介面中方法的程式代碼範例,請參閱 音訊會話事件。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | audiopolicy.h |