IMFTranscodeSinkInfoProvider

トランスコードシンクのアクティベーションオブジェクトによって実装されます。

このインターフェイスを使用するには、次の手順を実行します。

1. MFCreateTranscodeSinkActivate を呼び出して、トランスコードシンクのアクティベーションオブジェクトを作成します。
2. アクティベーションオブジェクトに対して IMFTranscodeSinkInfoProvider インターフェイスをクエリします。
3. MFCreateTranscodeProfile を呼び出して、トランスコードプロファイルを作成します。
4. トランスコードプロファイルに MF_TRANSCODE_CONTAINERTYPE 属性を設定します。この属性には、次のいずれかの値を指定する必要があります。
   • MFTranscodeContainerType_3GP
   • MFTranscodeContainerType_MP3
   • MFTranscodeContainerType_MPEG4
5. IMFTranscodeProfile::SetVideoAttributes および IMFTranscodeProfile::SetAudioAttributes を呼び出して、ビデオおよびオーディオの形式を指定します。
6. IMFTranscodeSinkInfoProvider::SetProfile を呼び出して、トランスコードプロファイルを設定します。
7. 次のいずれかのメソッド(両方ではありません)を呼び出して、出力ファイルを指定します。
   • IMFTranscodeSinkInfoProvider::SetOutputByteStream
   • IMFTranscodeSinkInfoProvider::SetOutputFile
8. アクティベーションオブジェクトに対して IMFActivate::ActivateObject を呼び出して、メディアシンクを作成します。

例

// Creates an activation object for the generic transcode sink.

HRESULT CreateTranscodeSinkActivate(
    REFGUID         guidContainerType,
    IMFAttributes   *pVideoAttributes,
    IMFAttributes   *pAudioAttributes,
    IMFActivate     *pByteStreamActivate, 
    IMFActivate     **ppSinkActivate
    )
{
    IMFActivate* pSinkActivate = NULL;
    IMFTranscodeSinkInfoProvider* pSinkInfoProvider = NULL;
    IMFTranscodeProfile* pProfile = NULL;
    IMFAttributes* pContainerAttributes = NULL;

    HRESULT hr = MFCreateAttributes(&pContainerAttributes, 1);
    if (FAILED(hr))
    {
        goto done;
    }

    // Create the transcode profile.
    hr = MFCreateTranscodeProfile(&pProfile);
    if (FAILED(hr))
    {
        goto done;
    }

    // Set the profile attributes.

    hr = pContainerAttributes->SetGUID(MF_TRANSCODE_CONTAINERTYPE, guidContainerType);
    if (FAILED(hr))
    {
        goto done;
    }

    hr = pProfile->SetContainerAttributes(pContainerAttributes);
    if (FAILED(hr))
    {
        goto done;
    }

    if (pVideoAttributes)
    {
        hr = pProfile->SetVideoAttributes(pVideoAttributes);
        if (FAILED(hr))
        {
            goto done;
        }
    }

    if (pAudioAttributes)
    {
        hr = pProfile->SetAudioAttributes(pAudioAttributes);
        if (FAILED(hr))
        {
            goto done;
        }
    }

    // Create the transcode sink activation object.
    hr = MFCreateTranscodeSinkActivate(&pSinkActivate);
    if (FAILED(hr))
    {
        goto done;
    }

    hr = pSinkActivate->QueryInterface(IID_PPV_ARGS(&pSinkInfoProvider));
    if (FAILED(hr))
    {
        goto done;
    }

    // Set the output byte stream.
    hr = pSinkInfoProvider->SetOutputByteStream(pByteStreamActivate);
    if (FAILED(hr))
    {
        goto done;
    }

    // Set the transcode profile.
    hr = pSinkInfoProvider->SetProfile(pProfile);
    if (FAILED(hr))
    {
        goto done;
    }

    // Return the activation object to the caller.
    *ppSinkActivate = pSinkActivate;
    (*ppSinkActivate)->AddRef();

done:
    SafeRelease(&pProfile);
    SafeRelease(&pSinkInfoProvider);
    SafeRelease(&pSinkActivate);
    SafeRelease(&pContainerAttributes);
    return hr;
}

エンコードされた出力ファイルの名前を設定します。

このメソッドが成功すると、S_OK を返します。それ以外の場合は、HRESULT エラーコードを返します。

メディアシンクは、指定されたファイル名でローカルファイルを作成します。

あるいは、IMFTranscodeSinkInfoProvider::SetOutputByteStream を呼び出して、トランスコードされたデータを受け取るバイトストリームを指定することもできます。これら 2 つのメソッドは相互に排他的です。

トランスコードメディアシンクの出力バイトストリームを設定します。

このメソッドが成功すると、S_OK を返します。それ以外の場合は、HRESULT エラーコードを返します。

トランスコードされたデータを受け取る、書き込み可能なバイトストリームを提供するには、このメソッドを呼び出します。

あるいは、IMFTranscodeSinkInfoProvider::SetOutputFile を呼び出して出力ファイルの名前を指定することもできます。これら 2 つのメソッドは相互に排他的です。

pByteStreamActivate パラメーターには、書き込み可能なバイトストリームを作成するアクティベーションオブジェクトを指定する必要があります。内部的には、トランスコードメディアシンクは次のように IMFActivate::ActivateObject を呼び出してバイトストリームを作成します。

IMFByteStream *pByteStream = NULL;

HRESULT hr = pByteStreamActivate->ActivateObject(IID_IMFByteStream, (void**)&pByteStream);

現在、Microsoft Media Foundation はバイトストリームのアクティベーションオブジェクトを一切提供していません。このメソッドを使用するには、アプリケーションが IMFActivate のカスタム実装を提供する必要があります。

トランスコードシンクのアクティベーションオブジェクトにトランスコードプロファイルを設定します。

このメソッドが成功すると、S_OK を返します。それ以外の場合は、HRESULT エラーコードを返します。

このメソッドを呼び出す前に、プロファイルオブジェクトを次のように初期化します。

• 出力ファイルのコンテナータイプを指定するために、MF_TRANSCODE_CONTAINERTYPE 属性を設定します。
• 出力ファイルにビデオストリームが含まれる場合は、IMFTranscodeProfile::SetVideoAttributes メソッドを呼び出してビデオ属性を設定します。
• 出力ファイルにオーディオストリームが含まれる場合は、IMFTranscodeProfile::SetAudioAttributes メソッドを呼び出してオーディオ属性を設定します。

トランスコードプロファイルで指定されたオーディオおよびビデオストリームのメディアタイプを取得します。

このメソッドが成功すると、S_OK を返します。それ以外の場合は、HRESULT エラーコードを返します。

このメソッドを呼び出す前に、IMFTranscodeSinkInfoProvider::SetProfile を呼び出してトランスコードプロファイルを設定します。GetSinkInfo メソッドは、このプロファイルを使用してオーディオおよびビデオストリームのメディアタイプを作成します。