AudioSessionState 列挙 (audiosessiontypes.h)
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 |