IAudioSessionEvents：：OnStateChanged 方法 (audiopolicy.h)

OnStateChanged 方法會通知用戶端會話的數據流活動狀態已變更。

語法

HRESULT OnStateChanged(
  [in] AudioSessionState NewState
);

參數

[in] NewState

新的工作階段狀態。 此參數的值是下列其中一個 AudioSessionState 列舉值：

AudioSessionStateActive

AudioSessionStateInactive

AudioSessionStateExpired

傳回值

如果方法成功，它會傳回 S_OK。 如果方法失敗，則會傳回錯誤碼。

備註

用戶端無法產生工作階段狀態變更事件。 系統一律是這種類型的事件來源。 因此，不同於其他一些 IAudioSessionEvents 方法，此方法不提供內容參數。

系統會在用戶端在會話中開啟第一個數據流時，將會話的狀態從非作用中變更為作用中。 用戶端會呼叫 IAudioClient：：Initialize 方法來開啟數據流。 系統會在用戶端關閉會話的最後一個數據流時，將會話狀態從作用中變更為非作用中。 釋放 IAudioClient 對象最後一個參考的用戶端會關閉與 對象相關聯的數據流。

如需實作 IAudioSessionEvents 介面中方法的程式代碼範例，請參閱 音訊會話事件。

規格需求

另請參閱

IAudioClient 介面

IAudioClient：：Initialize

IAudioSessionEvents 介面