AudioSessionState 列挙 (audiosessiontypes.h)

[アーティクル]
02/23/2024

AudioSessionState 列挙は、オーディオセッションの現在の状態を示す定数を定義します。

構文

typedef enum _AudioSessionState {
  AudioSessionStateInactive,
  AudioSessionStateActive,
  AudioSessionStateExpired
} AudioSessionState;

定数


`AudioSessionStateInactive` オーディオセッションが非アクティブです。 (少なくとも 1 つのストリームが含まれていますが、セッション内のどのストリームも現在実行されません)。
`AudioSessionStateActive` オーディオセッションがアクティブです。 (セッション内の少なくとも 1 つのストリームが実行されています。
`AudioSessionStateExpired` オーディオセッションの有効期限が切れています。 (ストリームは含まれない)。

注釈

クライアントがセッションに最初のストリームを割り当ててセッションを開くと ( IAudioClient::Initialize メソッドを呼び出すことによって)、初期セッション状態は非アクティブになります。セッションのストリームの実行が開始されると、セッションの状態が非アクティブからアクティブに変わります (クライアントが IAudioClient::Start メソッドを呼び出したため)。セッションは、クライアントがセッション内で最後に実行されているストリームを停止すると ( IAudioClient::Stop メソッドを呼び出すことによって) アクティブから非アクティブに変わります。セッションの状態は、クライアントがストリームオブジェクトへのすべての参照を解放することによってセッション内の最後のストリームを破棄すると、期限切れに変わります。

システム・ボリューム制御プログラム Sndvol は、アクティブ・セッションと非アクティブ・セッションの両方のボリューム・コントロールを表示します。 Sndvol は、セッションの状態が期限切れに変わると、セッションのボリューム制御の表示を停止します。 Sndvol の詳細については、「オーディオセッション」を参照してください。

IAudioSessionControl::GetState メソッドと IAudioSessionEvents::OnStateChanged メソッドは、AudioSessionState 列挙で定義されている定数を使用します。

セッションの状態の詳細については、「オーディオセッション」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ \| UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリ \| UWP アプリ]
Header	audiosessiontypes.h