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 インターフェイス