IMFASFSplitter

Advanced Systems Format (ASF) ファイルからデータを読み取るためのメソッドを提供します。

ASF スプリッターは ASF パケットを受け取り、そこから個々のストリームのサンプルを抽出します。他の ASF 基本コンポーネントと同様に、ASF スプリッターオブジェクトは使用前に ASF ContentInfo オブジェクトのデータで初期化する必要があります。

Advanced Systems Format (ASF) スプリッターをリセットし、ASF データセクションからデータを解析するように構成します。

このメソッドは HRESULT を返します。指定できる値には、次の表の値が含まれますが、これらに限定されません。

Advanced Systems Format (ASF) スプリッターにオプションフラグを設定します。

このメソッドは HRESULT を返します。指定できる値には、次の表の値が含まれますが、これらに限定されません。

このメソッドは、スプリッターの初期化後にのみ呼び出すことができます。

ASF スプリッターに設定されているオプションフラグを取得します。

このメソッドは HRESULT を返します。指定できる値には、次の表の値が含まれますが、これらに限定されません。

Advanced Systems Format (ASF) スプリッターによって解析されるストリームを設定します。

このメソッドは HRESULT を返します。指定できる値には、次の表の値が含まれますが、これらに限定されません。

このメソッドを呼び出すと、以前のストリーム選択はすべて上書きされます。pwStreamNumbers 配列で指定されたストリームのみが選択されます。

既定では、スプリッターによって選択されているストリームはありません。

現在選択されているストリームの一覧は、IMFASFSplitter::GetSelectedStreams メソッドを呼び出して取得できます。

現在選択されているストリームの一覧を取得します。

このメソッドは HRESULT を返します。指定できる値には、次の表の値が含まれますが、これらに限定されません。

選択されているストリームの数を取得するには、pwStreamNumbers を NULL に設定します。メソッドは MF_E_BUFFERTOSMALL を返しますが、*pwNumStreams の値も選択されているストリームの数に設定します。次に、そのサイズの配列を割り当て、pwStreamNumbers パラメーターに配列を渡してメソッドを再度呼び出します。

次のコードは、これらの手順を示しています。

HRESULT DisplaySelectedStreams(IMFASFSplitter *pSplitter)
{
    WORD count = 0;
    HRESULT hr = pSplitter->GetSelectedStreams(NULL, &count);
    if (hr == MF_E_BUFFERTOOSMALL)
    {
        WORD *pStreamIds = new (std::nothrow) WORD[count];
        if (pStreamIds)
        {
            hr = pSplitter->GetSelectedStreams(pStreamIds, &count);
            if (SUCCEEDED(hr))
            {
                for (WORD i = 0; i < count; i++)
                {
                    printf("Selected stream ID: %d\n", pStreamIds[i]);
                }
            }
            delete [] pStreamIds;
        }
        else
        {
            hr = E_OUTOFMEMORY;
        }
    }
    return hr;
}

あるいは、ストリームの総数に等しい配列を割り当て、それを pwStreamNumbers に渡すこともできます。

このメソッドを呼び出す前に、*pwNumStreams を pwStreamNumbers 内の要素数に初期化してください。pwStreamNumbers が NULL の場合は、*pwNumStreams を 0 に設定します。

既定では、スプリッターによって選択されているストリームはありません。IMFASFSplitter::SelectStreams メソッドを呼び出してストリームを選択します。

パケット化された Advanced Systems Format (ASF) データを処理のために ASF スプリッターに送信します。

このメソッドは HRESULT を返します。指定できる値には、次の表の値が含まれますが、これらに限定されません。

このメソッドを使用してデータを解析した後は、IMFASFSplitter::GetNextSample を呼び出して、解析されたメディアサンプルを取得する必要があります。

ASF データに可変サイズのパケットが含まれている場合は、バッファーに MFASFSPLITTER_PACKET_BOUNDARY 属性を設定してサンプルの境界を示す必要があり、バッファーが複数のパケットにまたがることはできません。

メソッドが ME_E_NOTACCEPTING を返した場合は、GetNextSample を呼び出して出力サンプルを取得するか、IMFASFSplitter::Flush を呼び出してスプリッターをクリアします。

スプリッターは入力バッファーの参照カウントを保持している場合があります。したがって、このメソッドを呼び出した後は、バッファー内の有効なデータを上書きしないでください。

データが解析された後、Advanced Systems Format (ASF) スプリッターからサンプルを取得します。

このメソッドは HRESULT を返します。指定できる値には、次の表の値が含まれますが、これらに限定されません。

このメソッドを呼び出す前に、IMFASFSplitter::ParseData を呼び出して、スプリッターに入力データを渡してください。入力に完全なサンプルを構成するのに十分なデータが含まれていない場合、GetNextSample メソッドは成功しますが、ppISample パラメーターに NULL を返します。

ASF スプリッターは、選択されていないストリームのサンプルをスキップします。ストリームを選択するには、IMFASFSplitter::SelectStreams を呼び出します。

Advanced Systems Format (ASF) スプリッターをリセットし、保留中のすべてのサンプルを解放します。

このメソッドは HRESULT を返します。指定できる値には、次の表の値が含まれますが、これらに限定されません。

Flush が呼び出されたときに取得待ちであったサンプルはすべて失われます。

最後に受信したサンプルの送信時刻を取得します。

このメソッドは HRESULT を返します。指定できる値には、次の表の値が含まれますが、これらに限定されません。