次の方法で共有

ACX_STREAM_STATE列挙 (acxstreams.h)

  • [アーティクル]

ACX_STREAM_STATE では、Acx ストリーム状態フラグについて説明します。

構文

typedef enum _ACX_STREAM_STATE {
  AcxStreamStateStop,
  AcxStreamStateAcquire,
  AcxStreamStatePause,
  AcxStreamStateRun,
  AcxStreamStateMaximum
} ACX_STREAM_STATE, *PACX_STREAM_STATE;

定数

 
AcxStreamStateStop
停止されている Acx ストリームの状態について説明します。
AcxStreamStateAcquire
取得中の Acx ストリーム状態について説明します。 この状態は内部でのみ使用されます。ストリームは、AcxStreamStateStop から AcxStreamStatePause に直接、または AcxStreamStatePause から AcxStreamStateStop に直接遷移します。
AcxStreamStatePause
Acx ストリーム状態を一時停止として記述します。
AcxStreamStateRun
Acx ストリームの状態を実行中として記述します。
AcxStreamStateMaximum
Acx Stream State Maximum について説明します。 この値は、内部検証に使用されます。

備考

AcxStream では、さまざまな状態がサポートされます。 これらの状態は、オーディオが流れている (RUN 状態) かフローしていない (PAUSE または STOP 状態) かを示します。

ストリームが作成され、適切なバッファーが割り当てられると、ストリームは、ストリームの開始を待機している一時停止状態になります。 クライアントがストリームを Play 状態にすると、ACX フレームワークはストリームに関連付けられているすべての回線を呼び出して、ストリームの状態が Play であることを示します。 その後、ACXPIN は Play 状態になり、その時点でデータのフローが開始されます。

ストリームが作成され、リソースが割り当てられると、アプリケーションはストリームで Start を呼び出して再生を開始します。

クライアントは、まずバッファーを事前にローリングします。 クライアントが ReleaseBuffer を呼び出すと、これは、アクティブな ACXSTREAM で EvtAcxStreamSetRenderPacket を呼び出す ACX レイヤーを呼び出す AudioKSE の呼び出しに変換されます。 このプロパティには、パケット インデックス (0 ベース) と、必要に応じて、現在のパケット内のストリームの末尾のバイト オフセットを含む EOS フラグが含まれます。

ACX デバイスの電源ダウンと削除中にストリームが存在する場合、ACX SetState コールバックが呼び出され、すべての回線のストリームが Pause に遷移します。 これは、スコープが設定された Stream インスタンスです。

  • AcxStreamCreate の後、AcxStream は AcxStreamStateStop 状態になります。
  • EvtAcxStreamPrepareHardware が正常に返された後、AcxStream は AcxStreamStatePause 状態になります。
  • EvtAcxStreamRun が正常に返された後、AcxStream は AcxStreamStateRun 状態になります。
  • EvtAcxStreamPause が返された後、AcxStream は AcxStreamStatePause 状態になります。
  • EvtAcxReleaseHardware が返された後、AcxStream は AcxStreamStop 状態になります。

例

使用例を次に示します。

    ACX_STREAM_STATE    m_CurrentState;
...
    if (m_CurrentState != AcxStreamStatePause)
    {
        status = STATUS_INVALID_STATE_TRANSITION;
        return status;
    }

ACX の要件

最小 ACX バージョン: 1.0

ACX バージョンの詳細については、ACX バージョンの概要 参照してください。

必要条件

要件 価値
ヘッダー acxstreams.h

関連項目

  • acxstreams.h ヘッダー を する