CSourceSeeking クラス

[アーティクル]
04/22/2010

CSourceSeeking クラスの階層

CSourceSeeking クラスは、1 つの出力ピンを持つソースフィルタで、シークを実装する抽象クラスである。

このクラスは、IMediaSeeking インターフェイスをサポートする。このクラスは、すべての IMediaSeeking メソッドにデフォルトの実装を提供する。プロテクトメンバ変数は、開始タイム、終了タイム、および現在の速度を格納する。デフォルトでは、このクラスによってサポートされる唯一のタイムフォーマットは、TIME_FORMAT_MEDIA_TIME (100 ナノ秒単位) である。詳細は、注意を参照すること。

要件

ヘッダー : Ctlutil.h 内で宣言し、Streams.h をインクルードする。

ライブラリ : Strmbase.lib (リテールビルド) または Strmbasd.lib (デバッグビルド) を使う。

プロテクトメンバ変数
m_rtDuration	ストリームの時間幅。
m_rtStart	開始タイム。
m_rtStop	終了タイム。
m_dRateSeeking	再生速度。
m_dwSeekingCaps	シーク能力。
m_pLock	ロックのためのクリティカルセクションオブジェクトへのポインタ。
プロテクトメソッド
CSourceSeeking	コンストラクタメソッド。
純粋仮想メソッド
ChangeRate	再生速度が変更されたときに呼び出される。
ChangeStart	開始位置が変更されたときに呼び出される。
ChangeStop	停止位置が変更されたときに呼び出される。
IMediaSeeking メソッド
IsFormatSupported	指定したタイムフォーマットがサポートされているかどうかを調べる。
QueryPreferredFormat	オブジェクトの優先タイムフォーマットを取得する。
SetTimeFormat	タイムフォーマットを設定する。
IsUsingTimeFormat	指定したタイムフォーマットが現在使われているフォーマットかどうかを調べる。
GetTimeFormat	現在のタイムフォーマットを取得する。
GetDuration	ストリームの時間幅を取得する。
GetStopPosition	ストリームの時間幅を基準として、再生が停止するタイムを取得する。
GetCurrentPosition	ストリームの合計時間幅を基準とする、現在の位置を取得する。
GetCapabilities	ストリームのすべてのシーク能力を取得する。
CheckCapabilities	指定したシーク能力をストリームが持っているかどうかを照会する。
ConvertTimeFormat	1 つのタイムフォーマットから別のタイムフォーマットに変換する。
SetPositions	現在位置と停止位置を設定する。
GetPositions	現在位置と停止位置を取得する。
GetAvailable	シークが有効なタイムの範囲を取得する。
SetRate	再生速度を設定する。
GetRate	再生速度を取得する。
GetPreroll	プリロールタイムを取得する。

注意

CSourceSeeking オブジェクトは、開始位置、停止位置、再生速度が変更されるたびに、次のように対応する純粋仮想メソッドを呼び出す。

派生クラスは、これらのメソッドを実装しなければならない。シーク処理後、フィルタは次のことを行う必要がある。

ダウンストリームの入力ピンで IPin::BeginFlush メソッドを呼び出す。
データを提供するワーカースレッドを停止する。
入力ピンで IPin::EndFlush メソッドを呼び出す。
ワーカースレッドを再起動する。
入力ピンで IPin::NewSegment メソッドを呼び出す。
最初のサンプルで非継続プロパティを設定する。IMediaSample::SetDiscontinuity メソッドを呼び出す。

ワーカースレッドがブロックされ、サンプル出力の待機状態になっている場合は、BeginFlush を呼び出してワーカースレッドを解放する。

ステップ 2 で、スレッドによるデータの送信が停止したことを確認する。実装によっては、スレッドが終了するのを待つか、またはスレッドが何らかの応答を示すまで待つ必要がある。フィルタで CSourceStream クラスを使っている場合、CSourceStream::Stop メソッドは、ワーカースレッドが応答するまで待機状態となる。

理想的には、新しいセグメント (ステップ 5) がワーカースレッドから提供されることが望ましい。これは、フィルタがサンプルを使って継続して処理する限り、CSourceSeeking オブジェクトによっても実行できる。

次の例は、可能な実装を示している。ここでは、ソースフィルタの出力ピンが CSourceSeeking と CSourceStream から派生することを想定している。この例では、ステップ 1 ～ 4 を実行するヘルパーメソッド UpdateFromSeek を定義している。CSourceStream::OnThreadStartPlay メソッドはオーバーライドされ、新しいセグメントを送ると共に、非連続を示すフラグを設定する。ワーカースレッドはこのフラグをピックアップし、IMediaSample::SetDiscontinuity を呼び出す。

void CMyStream::UpdateFromSeek()
{
    if (ThreadExists()) 
    {
        DeliverBeginFlush();
        Stop();
        DeliverEndFlush();
        Run();
    }
}

HRESULT CMyStream::OnThreadStartPlay()
{
    m_bDiscontinuity = TRUE;
    return DeliverNewSegment(m_rtStart, m_rtStop, m_dRateSeeking);
}

追加のタイムフォーマットのサポート

デフォルトでは、このクラスは、基準タイム (TIME_FORMAT_MEDIA_TIME) の単位のみのシークをサポートする。追加のタイムフォーマットをサポートするには、タイムフォーマットを扱う IMediaSeeking メソッドをオーバーライドする。

また、残りの IMediaSeeking メソッドをオーバーライドして、タイムフォーマット間で必要な変換を実行する。SetTimeFormat メソッドが呼び出された後、すべての IMediaSeeking メソッドは、出入りするタイムパラメータが新規のタイムフォーマットであるかのように扱う必要がある。たとえば、m_rtDuration 変数が基準タイムの単位の時間幅を表し、現在のタイムフォーマットがフレームである場合、GetDuration メソッドは、フレームに変換された値 m_rtDuration を返す必要がある。以下に例を示す。

STDMETHODIMP GetDuration(LONGLONG *pDuration)
{
    HRESULT hr = CSourceSeeking::GetDuration(pDuration);
    if (SUCCEEDED(hr))
    {
        if (m_TimeFormat == TIME_FORMAT_FRAME)
        {
            // 基準タイムからフレームへの変換。
            *pDuration = TimeToFrame(*pDuration);  // プライベート メソッド。
        }
    }
    return hr
}

また、IMediaSeeking::SetPositions メソッドの AM_SEEKING_ReturnTime フラグを確認する必要がある。このフラグがある場合は、呼び出し元に返すときに位置値を基準タイムに変換する。

CSourceSeeking クラス

その他のリソース