チュートリアル: シングルパス Windows Media エンコード

[アーティクル]
06/13/2023

エンコードとは、デジタルメディアをある形式から別の形式に変換するプロセスを指します。たとえば、MP3 オーディオを、Advanced Systems Format (ASF) 仕様によって定義される Windows Media Audio 形式に変換します。

注意: ASF 仕様では、出力ファイル (.wma または .wmv) のコンテナーの種類を定義します。このコンテナーの種類には、圧縮、非圧縮を問わず、あらゆる形式のメディアデータを含めることができます。たとえば、.wma ファイルなどの ASF コンテナーには、MP3 形式のメディアデータを含めることができます。エンコードプロセスは、ファイルに含まれるデータの実際の形式を変換します。

このチュートリアルでは、パイプラインレイヤー ASF コンポーネントを使用して、クリアコンテンツ (DRM で保護されていない) の入力ソースを Windows Media コンテンツにエンコードし、新しい ASF ファイル (.wm*) にデータを書き込む方法について説明します。これらのコンポーネントは、メディアセッションのインスタンスによって制御される部分エンコードトポロジを構築するために使用されます。

このチュートリアルでは、入力ファイル名と出力ファイル名、およびエンコードモードを引数として受け取るコンソールアプリケーションを作成します。入力ファイルは、圧縮または非圧縮のメディア形式にすることができます。有効なエンコードモードは、"CBR" (定数ビットレート) または "VBR" (可変ビットレート) です。アプリケーションは、入力ファイル名で指定されたソースを表すメディアソースと、ソースファイルのエンコードされた内容を ASF ファイルにアーカイブする ASF ファイルシンクを作成します。シナリオを簡単に実装できるように、出力ファイルには、1 つのオーディオストリームと 1 つのビデオストリームのみが含まれます。アプリケーションは、オーディオストリーム形式変換用の Windows Media Audio 9.1 Professional コーデックと、ビデオストリーム用の Windows Media Video 9 コーデックを挿入します。

定数ビットレートエンコードの場合、エンコードセッションが開始される前に、エンコーダーは、実現する必要があるターゲットのビットレートを認識している必要があります。このチュートリアルでは、"CBR" モードの場合、アプリケーションは、メディアタイプネゴシエーション中にエンコーダーから取得された最初の出力メディアの種類で使用可能なビットレートを、ターゲットビットレートとして使用します。可変ビットレートエンコードの場合、このチュートリアルでは、品質レベルを設定して可変ビットレートでエンコードする方法について説明します。オーディオストリームは品質レベル 98 でエンコードされ、ビデオストリームは品質レベル 95 でエンコードされます。

以下は、シングルパスエンコードモードを使用して ASF コンテナー内の Windows Media コンテンツをエンコードする手順をまとめたものです。

ソースリゾルバーを使用して、指定されたメディアソースを作成します。
メディアソース内のストリームを列挙します。
ASF メディアシンクを作成し、エンコードする必要があるメディアソース内のストリームに応じてストリームシンクを追加します。
必要なエンコードプロパティを使用してメディアシンクを構成します。
出力ファイル内のストリーム用の Windows Media エンコーダーを作成します。
メディアシンクに設定されているプロパティを使用してエンコーダーを構成します。
部分エンコードトポロジを構築します。
メディアセッションをインスタンス化し、メディアセッションでトポロジを設定します。
メディアセッションを制御し、関連するすべてのイベントをメディアセッションから取得して、エンコードセッションを開始します。
VBR エンコードの場合は、エンコーダーからエンコードプロパティの値を取得し、メディアシンクに設定します。
エンコードセッションを閉じてシャットダウンします。

このチュートリアルは次のセクションで構成されています。

前提条件
プロジェクトをセットアップする
メディアソースを作成する
ASF ファイルシンクを作成する
部分エンコードトポロジを構築する
エンコードセッションを処理する
ファイルシンクのエンコードプロパティを更新する
main を実装する
出力ファイルをテストする
一般的なエラーコードとデバッグのヒント
関連トピック

前提条件

このチュートリアルでは、次のことを前提としています。

ASF オブジェクトを操作するためにメディアファンデーションによって提供されるパイプラインレイヤー ASF コンポーネントである、ASF ファイル構造について熟知している。これらのコンポーネントには次のオブジェクトが含まれます。
- メディアソース
  
  注意: トランスレート (形式を変更せずに、高いビットレートファイルを低いビットレートファイルに変換する) を実行する場合は、ASF メディアソースを使用します。
- Windows Media エンコーダー
- ASF メディアシンク
- ASF ContentInfo オブジェクト
- ASF プロファイル
Windows Media エンコーダーと、さまざまなエンコードの種類 (特に定数ビットレートエンコードと品質ベースの可変ビットレートエンコード) について熟知している。
エンコーダー MFT の操作に熟知している。具体的には、エンコーダーのインスタンスを作成し、エンコーダーに入力と出力の種類を設定します。
トポロジオブジェクトと、エンコードトポロジを構築する方法について熟知している。トポロジとトポロジノードの詳細については、「トポロジの作成」を参照してください。
メディアセッションのイベントモデルとフロー制御演算について熟知している。詳細については、「メディアセッションイベント」を参照してください。

プロジェクトをセットアップする

ソースファイルに次のヘッダーを含めます。

#include <new>
#include <mfidl.h>            // Media Foundation interfaces
#include <mfapi.h>            // Media Foundation platform APIs
#include <mferror.h>        // Media Foundation error codes
#include <wmcontainer.h>    // ASF-specific components
#include <wmcodecdsp.h>        // Windows Media DSP interfaces
#include <Dmo.h>            // DMO objects
#include <uuids.h>            // Definition for FORMAT_VideoInfo
#include <propvarutil.h>

次のライブラリファイルにリンクします。

// The required link libraries 
#pragma comment(lib, "mfplat")
#pragma comment(lib, "mf")
#pragma comment(lib, "mfuuid")
#pragma comment(lib, "msdmo")
#pragma comment(lib, "strmiids")
#pragma comment(lib, "propsys")

SafeRelease 関数を宣言します。

template <class T> void SafeRelease(T **ppT)
{
    if (*ppT)
    {
        (*ppT)->Release();
        *ppT = NULL;
    }
}

ENCODING_MODE 列挙型を宣言して、CBR および VBR エンコードの種類を定義します。

// Encoding mode
typedef enum ENCODING_MODE {
  NONE  = 0x00000000,
  CBR   = 0x00000001,
  VBR   = 0x00000002,
} ;

ビデオストリームのバッファーウィンドウの定数を定義します。
```
// Video buffer window
const INT32 VIDEO_WINDOW_MSEC = 3000;
```

メディアソースを作成する

入力ソースのメディアソースを作成します。メディアファンデーションには、MP3、MP4/3GP、AVI/WAVE など、さまざまなメディア形式用の組み込みメディアソースが用意されています。メディアファンデーションでサポートされている形式の詳細については、「メディアファンデーションでサポートされるメディア形式」を参照してください。

メディアソースを作成するには、ソースリゾルバーを使用します。このオブジェクトは、ソースファイルに指定された URL を分析し、適切なメディアソースを作成します。

次の呼び出しを行います。

MFCreateSourceResolver
IMFSourceResolver::CreateObjectFromURL

これらの呼び出しの詳細については、「ソースリゾルバーの使用」を参照してください。

入力ファイルが ASF 形式で、形式を変更せずに別のビットレートファイルに変換する場合は、ソースソルバーによって ASF メディアソースのインスタンスが作成されます。

次のコード例は、指定したファイルのメディアソースを作成する関数、CreateMediaSource を示しています。

//  Create a media source from a URL.
HRESULT CreateMediaSource(PCWSTR sURL, IMFMediaSource **ppSource)
{
    MF_OBJECT_TYPE ObjectType = MF_OBJECT_INVALID;

    IMFSourceResolver* pSourceResolver = NULL;
    IUnknown* pSource = NULL;

    // Create the source resolver.
    HRESULT hr = MFCreateSourceResolver(&pSourceResolver);
    if (FAILED(hr))
    {
        goto done;
    }

    // Use the source resolver to create the media source.

    // Note: For simplicity this sample uses the synchronous method to create 
    // the media source. However, creating a media source can take a noticeable
    // amount of time, especially for a network source. For a more responsive 
    // UI, use the asynchronous BeginCreateObjectFromURL method.

    hr = pSourceResolver->CreateObjectFromURL(
        sURL,                       // URL of the source.
        MF_RESOLUTION_MEDIASOURCE,  // Create a source object.
        NULL,                       // Optional property store.
        &ObjectType,        // Receives the created object type. 
        &pSource            // Receives a pointer to the media source.
        );
    if (FAILED(hr))
    {
        goto done;
    }

    // Get the IMFMediaSource interface from the media source.
    hr = pSource->QueryInterface(IID_PPV_ARGS(ppSource));

done:
    SafeRelease(&pSourceResolver);
    SafeRelease(&pSource);
    return hr;
}

ASF ファイルシンクを作成する

エンコードされたメディアデータをエンコードセッションの終了時に ASF ファイルにアーカイブする、ASF ファイルシンクのインスタンスを作成します。

このチュートリアルでは、ASF ファイルシンクのアクティブ化オブジェクトを作成します。必要なストリームシンクを作成するには、ファイルシンクに次の情報が必要になります。

最終ファイルでエンコードされ書き込まれるストリーム。
メディアコンテンツのエンコードに使用されるエンコードプロパティ (エンコードの種類、エンコードパスの数、関連プロパティなど)。
漏れバケットパラメーター (ビットレートとバッファーサイズ) を自動的に調整する必要があるかどうかをメディアシンクに示すグローバルファイルのプロパティ。

ストリーム情報は ASF プロファイルオブジェクトで構成され、エンコードプロパティとグローバルプロパティは、ASF ContentInfo オブジェクトによって管理されるプロパティストアで設定されます。

ASF ファイルシンクの概要については、「ASF メディアシンク」を参照してください。

ASF プロファイルオブジェクトを作成する

ASF ファイルシンクがエンコードされたメディアデータを ASF ファイルに書き込むには、ストリームシンクを作成するストリームの数とストリームの種類をシンクが認識している必要があります。このチュートリアルでは、メディアソースからその情報を抽出し、対応する出力ストリームを作成します。出力ストリームは、1 つのオーディオストリームと 1 つのビデオストリームに制限します。ソースで選んだストリームごとに、ターゲットストリームを作成し、プロファイルに追加します。

この手順を実装するには、次のオブジェクトが必要になります。

ASF プロファイル
メディアソースのプレゼンテーション記述子
メディアソースで選択したストリームのストリーム記述子
選択したストリームのメディアの種類

次の手順では、ASF プロファイルとターゲットストリームを作成するプロセスについて説明します。

ASF プロファイルを作成するには

MFCreateASFProfile を呼び出して、空のプロファイルオブジェクトを作成します。
IMFMediaSource::CreatePresentationDescriptor を呼び出して、このチュートリアルの「メディアソースを作成する」セクションで説明されている手順で作成したメディアソースのプレゼンテーション記述子を作成します。
IMFPresentationDescriptor::GetStreamDescriptorCount を呼び出して、メディアソース内のストリームの数を取得します。
メディアソース内の各ストリームに対して IMFPresentationDescriptor::GetStreamDescriptorByIndex を呼び出して、ストリームのストリーム記述子を取得します。
IMFStreamDescriptor::GetMediaTypeHandler の後に IMFMediaTypeHandler::GetMediaTypeByIndex を呼び出して、ストリームの最初のメディアの種類を取得します。

注意: 複雑な呼び出しを避けるため、ストリームごとに 1 つのメディアの種類のみが存在すると想定し、ストリームの最初のメディアの種類を選びます。複雑なストリームの場合は、メディアの種類ハンドラーから各メディアの種類を列挙し、エンコードするメディアの種類を選ぶ必要があります。
IIMFMediaType::GetMajorType を呼び出してストリームのメジャー型を取得し、ストリームにオーディオとビデオのどちらが含まれているかを判断します。
ストリームのメジャー型に応じて、ターゲットメディアの種類を作成します。これらのメディアの種類は、エンコードセッション中にエンコーダーが使用する形式情報を保持します。このチュートリアルの以降のセクションでは、ターゲットメディアの種類を作成するプロセスについて説明します。
- 圧縮オーディオメディアの種類を作成する
- 圧縮ビデオメディアの種類を作成する

ターゲットメディアの種類に基づいてストリームを作成し、アプリケーションの要件に従ってストリームを構成し、ストリームをプロファイルに追加します。詳細については、「ASF ファイルシンクへのストリーム情報の追加」を参照してください。

IMFASFProfile::CreateStream を呼び出して、ターゲットメディアの種類を渡して出力ストリームを作成します。このメソッドは、ストリームオブジェクトの IMFASFStreamConfig インターフェイスを取得します。
ストリームを構成します。
- IMFASFStreamConfig::SetStreamNumber を呼び出して、ストリームに番号を割り当てます。この設定は必須です。
- 必要に応じて、IMFASFStreamConfig メソッドと関連するストリーム構成属性を呼び出して、各ストリームで漏れバケットパラメーター、ペイロード拡張、相互排他を構成します。
ASF ContentInfo オブジェクトを使用して、ストリームレベルのエンコードプロパティを追加します。この手順の詳細については、このチュートリアルの「ASF ContentInfo オブジェクトを作成する」セクションを参照してください。
IMFASFProfile::SetStream を呼び出して、ストリームをプロファイルに追加します。

次のコード例では、出力オーディオストリームを作成します。

//-------------------------------------------------------------------
//  CreateAudioStream
//  Create an audio stream and add it to the profile.
//
//  pProfile: A pointer to the ASF profile.
//  wStreamNumber: Stream number to assign for the new stream.
//-------------------------------------------------------------------

HRESULT CreateAudioStream(IMFASFProfile* pProfile, WORD wStreamNumber)
{
    if (!pProfile)
    {
        return E_INVALIDARG;
    }
    if (wStreamNumber < 1 || wStreamNumber > 127 )
    {
        return MF_E_INVALIDSTREAMNUMBER;
    }

    IMFMediaType* pAudioType = NULL;
    IMFASFStreamConfig* pAudioStream = NULL;

    //Create an output type from the encoder
    HRESULT hr = GetOutputTypeFromWMAEncoder(&pAudioType);
    if (FAILED(hr))
    {
        goto done;
    }

    //Create a new stream with the audio type
    hr = pProfile->CreateStream(pAudioType, &pAudioStream);
    if (FAILED(hr))
    {
        goto done;
    }

    //Set stream number
    hr = pAudioStream->SetStreamNumber(wStreamNumber);
    if (FAILED(hr))
    {
        goto done;
    }

    //Add the stream to the profile
    hr = pProfile->SetStream(pAudioStream);
    if (FAILED(hr))
    {
        goto done;
    }

    wprintf_s(L"Audio Stream created. Stream Number: %d.\n", wStreamNumber);

done:
    SafeRelease(&pAudioStream);
    SafeRelease(&pAudioType);
    return hr;
}

次のコード例では、出力ビデオストリームを作成します。

//-------------------------------------------------------------------
//  CreateVideoStream
//  Create an video stream and add it to the profile.
//
//  pProfile: A pointer to the ASF profile.
//  wStreamNumber: Stream number to assign for the new stream.
//    pType: A pointer to the source's video media type.
//-------------------------------------------------------------------

HRESULT CreateVideoStream(IMFASFProfile* pProfile, WORD wStreamNumber, IMFMediaType* pType)
{
    if (!pProfile)
    {
        return E_INVALIDARG;
    }
    if (wStreamNumber < 1 || wStreamNumber > 127 )
    {
        return MF_E_INVALIDSTREAMNUMBER;
    }

    HRESULT hr = S_OK;


    IMFMediaType* pVideoType = NULL;
    IMFASFStreamConfig* pVideoStream = NULL;

    UINT32 dwBitRate = 0;

    //Create a new video type from the source type
    hr = CreateCompressedVideoType(pType, &pVideoType);
    if (FAILED(hr))
    {
        goto done;
    }

    //Create a new stream with the video type
    hr = pProfile->CreateStream(pVideoType, &pVideoStream);
    if (FAILED(hr))
    {
        goto done;
    }


    //Set a valid stream number
    hr = pVideoStream->SetStreamNumber(wStreamNumber);
    if (FAILED(hr))
    {
        goto done;
    }

    //Add the stream to the profile
    hr = pProfile->SetStream(pVideoStream);
    if (FAILED(hr))
    {
        goto done;
    }

    wprintf_s(L"Video Stream created. Stream Number: %d .\n", wStreamNumber);

done:

    SafeRelease(&pVideoStream);
    SafeRelease(&pVideoType);

    return hr;
}

次のコード例では、ソース内のストリームに応じて出力ストリームを作成します。

    //For each stream in the source, add target stream information in the profile
    for (DWORD iStream = 0; iStream < dwSrcStream; iStream++)
    {
        hr = pPD->GetStreamDescriptorByIndex(
            iStream, &fSelected, &pStreamDesc);
        if (FAILED(hr))
        {
            goto done;
        }

        if (!fSelected)
        {
            continue;
        }

        //Get the media type handler
        hr = pStreamDesc->GetMediaTypeHandler(&pHandler);
        if (FAILED(hr))
        {
            goto done;
        }

        //Get the first media type 
        hr = pHandler->GetMediaTypeByIndex(0, &pMediaType);
        if (FAILED(hr))
        {
            goto done;
        }

        //Get the major type
        hr = pMediaType->GetMajorType(&guidMajor);
        if (FAILED(hr))
        {
            goto done;
        }

        // If this is a video stream, create the target video stream
        if (guidMajor == MFMediaType_Video)
        {
            //The stream level encoding properties will be set in this call
            hr = CreateVideoStream(pProfile, wStreamID, pMediaType);

            if (FAILED(hr))
            {
                goto done;
            }
        }
        
        // If this is an audio stream, create the target audio stream
        if (guidMajor == MFMediaType_Audio)
        {
            //The stream level encoding properties will be set in this call
            hr = CreateAudioStream(pProfile, wStreamID);

            if (FAILED(hr))
            {
                goto done;
            }
        }

        //Get stream's encoding property
        hr = pContentInfo->GetEncodingConfigurationPropertyStore(wStreamID, &pContentInfoProps);
        if (FAILED(hr))
        {
            goto done;
        }

        //Set the stream-level encoding properties
        hr = SetEncodingProperties(guidMajor, pContentInfoProps);       
        if (FAILED(hr))
        {
            goto done;
        }


        SafeRelease(&pMediaType);
        SafeRelease(&pStreamDesc);
        SafeRelease(&pContentInfoProps);
        wStreamID++;
    }

圧縮オーディオメディアの種類を作成する

出力ファイルにオーディオストリームを含める場合は、必要な属性を設定してエンコードされた型の特性を指定して、オーディオの種類を作成します。オーディオの種類が Windows Media オーディオエンコーダーと互換性があることを確認するには、エンコーダー MFT をインスタンス化し、エンコードプロパティを設定し、IMFTransform::GetOutputAvailableType を呼び出してメディアの種類を取得します。使用可能なすべての種類をループ処理し、各メディアの種類の属性を取得し、要件に最も近い種類を選択して、必要な出力の種類を取得します。このチュートリアルでは、エンコーダーでサポートされている出力メディアの種類の一覧から、使用可能な最初の種類を取得します。

注意: Windows 7 の場合、メディアファンデーションには、互換性のあるオーディオの種類の一覧を取得する新しい関数、MFTranscodeGetAudioOutputAvailableTypes が用意されています。この関数は、CBR エンコードのメディアの種類のみを取得します。

完全なオーディオの種類には、次の属性が設定されている必要があります。

次のコード例では、Windows Media オーディオエンコーダーから互換性のある種類を取得して、圧縮オーディオの種類を作成します。 SetEncodingProperties の実装については、このチュートリアルの「ASF ContentInfo オブジェクトを作成する」セクションを参照してください。

//-------------------------------------------------------------------
//  GetOutputTypeFromWMAEncoder
//  Gets a compatible output type from the Windows Media audio encoder.
//
//  ppAudioType: Receives a pointer to the media type.
//-------------------------------------------------------------------

HRESULT GetOutputTypeFromWMAEncoder(IMFMediaType** ppAudioType)
{
    if (!ppAudioType)
    {
        return E_POINTER;
    }

    IMFTransform* pMFT = NULL;
    IMFMediaType* pType = NULL;
    IPropertyStore* pProps = NULL;

    //We need to find a suitable output media type
    //We need to create the encoder to get the available output types
    //and discard the instance.

    CLSID *pMFTCLSIDs = NULL;   // Pointer to an array of CLISDs. 
    UINT32 cCLSID = 0;            // Size of the array.

    MFT_REGISTER_TYPE_INFO tinfo;
    
    tinfo.guidMajorType = MFMediaType_Audio;
    tinfo.guidSubtype = MFAudioFormat_WMAudioV9;

    // Look for an encoder.
    HRESULT hr = MFTEnum(
        MFT_CATEGORY_AUDIO_ENCODER,
        0,                  // Reserved
        NULL,                // Input type to match. None.
        &tinfo,             // WMV encoded type.
        NULL,               // Attributes to match. (None.)
        &pMFTCLSIDs,        // Receives a pointer to an array of CLSIDs.
        &cCLSID             // Receives the size of the array.
        );
    if (FAILED(hr))
    {
        goto done;
    }

    // MFTEnum can return zero matches.
    if (cCLSID == 0)
    {
        hr = MF_E_TOPO_CODEC_NOT_FOUND;
        goto done;
    }
    else
    {
        // Create the MFT decoder
        hr = CoCreateInstance(pMFTCLSIDs[0], NULL,
            CLSCTX_INPROC_SERVER, IID_PPV_ARGS(&pMFT));

        if (FAILED(hr))
        {
            goto done;
        }

    }

    // Get the encoder's property store

    hr = pMFT->QueryInterface(IID_PPV_ARGS(&pProps));
    if (FAILED(hr))
    {
        goto done;
    }
    
    //Set encoding properties
    hr = SetEncodingProperties(MFMediaType_Audio, pProps);
    if (FAILED(hr))
    {
        goto done;
    }

    //Get the first output type
    //You can loop through the available output types to choose 
    //the one that meets your target requirements
    hr = pMFT->GetOutputAvailableType(0, 0, &pType);
    if (FAILED(hr))
    {
        goto done;
    }

    //Return to the caller
    *ppAudioType = pType;
    (*ppAudioType)->AddRef();
    
done:
    SafeRelease(&pProps);
    SafeRelease(&pType);
    SafeRelease(&pMFT);
    CoTaskMemFree(pMFTCLSIDs);
    return hr;
}

圧縮ビデオメディアの種類を作成する

出力ファイルにビデオストリームを含める場合は、完全にエンコードされたビデオの種類を作成します。完全なメディアの種類には、必要なビットレートとコーデックプライベートデータを含める必要があります。

完全なビデオメディアの種類を作成するには、2 通りの方法があります。

空のメディアの種類を作成し、ソースビデオの種類からメディアの種類の属性をコピーし、MF_MT_SUBTYPE 属性を GUID 定数 MFVideoFormat_WMV3 で上書きします。

完全なビデオの種類には、次の属性が設定されている必要があります。

MF_MT_MAJOR_TYPE
MF_MT_SUBTYPE
MF_MT_FRAME_RATE
MF_MT_FRAME_SIZE
MF_MT_INTERLACE_MODE
MF_MT_PIXEL_ASPECT_RATIO
MF_MT_AVG_BITRATE
MF_MT_USER_DATA

次のコード例では、ソースのビデオの種類から圧縮されたビデオの種類を作成します。

//-------------------------------------------------------------------
//  CreateCompressedVideoType
//  Creates an output type from source's video media type.
//
//    pType: A pointer to the source's video media type.
//  ppVideoType: Receives a pointer to the media type.
//-------------------------------------------------------------------

HRESULT CreateCompressedVideoType(
        IMFMediaType* pType, 
        IMFMediaType** ppVideoType)
{
    if (!pType)
    {
        return E_INVALIDARG;
    }
    if (!ppVideoType)
    {
        return E_POINTER;
    }

    HRESULT hr = S_OK;
    MFRatio fps = { 0 };
    MFRatio par = { 0 };
    UINT32 width = 0, height = 0;
    UINT32 interlace = MFVideoInterlace_Unknown;
    UINT32 fSamplesIndependent = 0;
    UINT32 cBitrate = 0;

    IMFMediaType* pMediaType = NULL;

    GUID guidMajor = GUID_NULL;

    hr = pType->GetMajorType(&guidMajor);
    if (FAILED(hr))
    {
        goto done;
    }

    if (guidMajor != MFMediaType_Video )
    {
        hr = MF_E_INVALID_FORMAT;
        goto done;
    }

    hr = MFCreateMediaType(&pMediaType);
    if (FAILED(hr))
    {
        goto done;
    }

    hr = pType->CopyAllItems(pMediaType);
    if (FAILED(hr))
    {
        goto done;
    }

    //Fill the missing attributes
    //1. Frame rate
    hr = MFGetAttributeRatio(pMediaType, MF_MT_FRAME_RATE, (UINT32*)&fps.Numerator, (UINT32*)&fps.Denominator);
    if (hr == MF_E_ATTRIBUTENOTFOUND)
    {
        fps.Numerator = 30000;
        fps.Denominator = 1001;

        hr = MFSetAttributeRatio(pMediaType, MF_MT_FRAME_RATE, fps.Numerator, fps.Denominator);
        if (FAILED(hr))
        {
            goto done;
        }
    }

    ////2. Frame size
    hr = MFGetAttributeSize(pMediaType, MF_MT_FRAME_SIZE, &width, &height);
    if (hr == MF_E_ATTRIBUTENOTFOUND)
    {
        width = 1280;
        height = 720;

        hr = MFSetAttributeSize(pMediaType, MF_MT_FRAME_SIZE, width, height);
        if (FAILED(hr))
        {
            goto done;
        }
    }

    ////3. Interlace mode

    if (FAILED(pMediaType->GetUINT32(MF_MT_INTERLACE_MODE, &interlace)))
    {
        hr = pMediaType->SetUINT32(MF_MT_INTERLACE_MODE, MFVideoInterlace_Progressive);
        if (FAILED(hr))
        {
            goto done;
        }

    }

    ////4. Pixel aspect Ratio
    hr = MFGetAttributeRatio(pMediaType, MF_MT_PIXEL_ASPECT_RATIO, (UINT32*)&par.Numerator, (UINT32*)&par.Denominator);
    if (hr == MF_E_ATTRIBUTENOTFOUND)
    {
        par.Numerator = par.Denominator = 1;
        hr = MFSetAttributeRatio(pMediaType, MF_MT_PIXEL_ASPECT_RATIO, (UINT32)par.Numerator, (UINT32)par.Denominator);
        if (FAILED(hr))
        {
            goto done;
        }

    }

    //6. bit rate
    if (FAILED(pMediaType->GetUINT32(MF_MT_AVG_BITRATE, &cBitrate)))
    {
        hr = pMediaType->SetUINT32(MF_MT_AVG_BITRATE, 1000000);
        if (FAILED(hr))
        {
            goto done;
        }

    }

    hr = pMediaType->SetGUID(MF_MT_SUBTYPE, MFVideoFormat_WMV3);
    if (FAILED(hr))
    {
        goto done;
    }

    // Return the pointer to the caller.
    *ppVideoType = pMediaType;
    (*ppVideoType)->AddRef();


done:
    SafeRelease(&pMediaType);
    return hr;
}

エンコードプロパティを設定し、IMFTransform::GetOutputAvailableType を呼び出して、Windows Media ビデオエンコーダーから互換性のあるメディアの種類を取得します。このメソッドは、部分型を返します。次の情報を追加して、部分型を完全な型に変換します。

MF_MT_AVG_BITRATE 属性でビデオビットレートを設定します。
MF_MT_USER_DATA 属性を設定して、コーデックプライベートデータを追加します。手順の詳細については、「WMV エンコーダーの構成」の「プライベートコーデックデータ」を参照してください。

IWMCodecPrivateData::GetPrivateData はコーデックプライベートデータを返す前にビットレートをチェックするため、コーデックプライベートデータを取得する前にビットレートを設定してください。

次のコード例では、Windows Media ビデオエンコーダーから互換性のある種類を取得して、圧縮ビデオの種類を作成します。また、圧縮されていないビデオの種類も作成し、エンコーダーの入力として設定します。これは、ヘルパー関数の CreateUncompressedVideoType で実装されます。 GetOutputTypeFromWMVEncoder は、コーデックプライベートデータを追加することによって、返された部分型を完全な型に変換します。 SetEncodingProperties の実装については、このチュートリアルの「ASF ContentInfo オブジェクトを作成する」セクションを参照してください。

//-------------------------------------------------------------------
//  GetOutputTypeFromWMVEncoder
//  Gets a compatible output type from the Windows Media video encoder.
//
//  pType: A pointer to the source video stream's media type.
//  ppVideoType: Receives a pointer to the media type.
//-------------------------------------------------------------------

HRESULT GetOutputTypeFromWMVEncoder(IMFMediaType* pType, IMFMediaType** ppVideoType)
{
    if (!ppVideoType)
    {
        return E_POINTER;
    }

    IMFTransform* pMFT = NULL;
    IPropertyStore* pProps = NULL;
    IMFMediaType* pInputType = NULL;
    IMFMediaType* pOutputType = NULL;

    UINT32 cBitrate = 0;

    //We need to find a suitable output media type
    //We need to create the encoder to get the available output types
    //and discard the instance.

    CLSID *pMFTCLSIDs = NULL;   // Pointer to an array of CLISDs. 
    UINT32 cCLSID = 0;          // Size of the array.

    MFT_REGISTER_TYPE_INFO tinfo;

    tinfo.guidMajorType = MFMediaType_Video;
    tinfo.guidSubtype = MFVideoFormat_WMV3;

    // Look for an encoder.
    HRESULT hr = MFTEnum(
        MFT_CATEGORY_VIDEO_ENCODER,
        0,                  // Reserved
        NULL,               // Input type to match. None.
        &tinfo,             // WMV encoded type.
        NULL,               // Attributes to match. (None.)
        &pMFTCLSIDs,        // Receives a pointer to an array of CLSIDs.
        &cCLSID             // Receives the size of the array.
        );
    if (FAILED(hr))
    {
        goto done;
    }

    // MFTEnum can return zero matches.
    if (cCLSID == 0)
    {
        hr = MF_E_TOPO_CODEC_NOT_FOUND;
        goto done;
    }
    else
    {
        //Create the MFT decoder
        hr = CoCreateInstance(pMFTCLSIDs[0], NULL,
            CLSCTX_INPROC_SERVER, IID_PPV_ARGS(&pMFT));
        if (FAILED(hr))
        {
            goto done;
        }

    }

    //Get the video encoder property store
    hr = pMFT->QueryInterface(IID_PPV_ARGS(&pProps));
    if (FAILED(hr))
    {
        goto done;
    }

    //Set encoding properties
    hr = SetEncodingProperties(MFMediaType_Video, pProps);
    if (FAILED(hr))
    {
        goto done;
    }

    hr = CreateUncompressedVideoType(pType, &pInputType);
    if (FAILED(hr))
    {
        goto done;
    }

    hr = pMFT->SetInputType(0, pInputType, 0);

    //Get the first output type
    //You can loop through the available output types to choose 
    //the one that meets your target requirements
    hr =  pMFT->GetOutputAvailableType(0, 0, &pOutputType);
    if (FAILED(hr))
    {
        goto done;
    }

    hr = pType->GetUINT32(MF_MT_AVG_BITRATE, &cBitrate);
    if (FAILED(hr))
    {
        goto done;
    }

    //Now set the bit rate
    hr = pOutputType->SetUINT32(MF_MT_AVG_BITRATE, cBitrate);
    if (FAILED(hr))
    {
        goto done;
    }

    hr = AddPrivateData(pMFT, pOutputType);
    if (FAILED(hr))
    {
        goto done;
    }

    //Return to the caller
    *ppVideoType = pOutputType;
    (*ppVideoType)->AddRef();

done:
    SafeRelease(&pProps);
    SafeRelease(&pOutputType);
    SafeRelease(&pInputType);
    SafeRelease(&pMFT);
    CoTaskMemFree(pMFTCLSIDs);
    return hr;
}

次のコード例では、圧縮されていないビデオの種類を作成します。

//-------------------------------------------------------------------
//  CreateUncompressedVideoType
//  Creates an uncompressed video type.
//
//    pType: A pointer to the source's video media type.
//  ppVideoType: Receives a pointer to the media type.
//-------------------------------------------------------------------

HRESULT CreateUncompressedVideoType(IMFMediaType* pType, IMFMediaType** ppMediaType)
{
    if (!pType)
    {
        return E_INVALIDARG;
    }
    if (!ppMediaType)
    {
        return E_POINTER;
    }

    MFRatio fps = { 0 };
    MFRatio par = { 0 };
    UINT32 width = 0, height = 0;
    UINT32 interlace = MFVideoInterlace_Unknown;
    UINT32 cBitrate = 0;

    IMFMediaType* pMediaType = NULL;

    GUID guidMajor = GUID_NULL;

    HRESULT hr = pType->GetMajorType(&guidMajor);
    if (FAILED(hr))
    {
        goto done;
    }

    if (guidMajor != MFMediaType_Video )
    {
        hr = MF_E_INVALID_FORMAT;
        goto done;
    }

    hr = MFGetAttributeRatio(pType, MF_MT_FRAME_RATE, (UINT32*)&fps.Numerator, (UINT32*)&fps.Denominator);
    if (hr == MF_E_ATTRIBUTENOTFOUND)
    {
        fps.Numerator = 30000;
        fps.Denominator = 1001;

    }
    hr = MFGetAttributeSize(pType, MF_MT_FRAME_SIZE, &width, &height);
    if (hr == MF_E_ATTRIBUTENOTFOUND)
    {
        width = 1280;
        height = 720;

    }

    interlace = MFGetAttributeUINT32(pType, MF_MT_INTERLACE_MODE, MFVideoInterlace_Progressive);

    hr = MFGetAttributeRatio(pType, MF_MT_PIXEL_ASPECT_RATIO, (UINT32*)&par.Numerator, (UINT32*)&par.Denominator);
    if (FAILED(hr))
    {
        par.Numerator = par.Denominator = 1;
    }

    cBitrate = MFGetAttributeUINT32(pType, MF_MT_AVG_BITRATE, 1000000);

    hr = MFCreateMediaType(&pMediaType);
    if (FAILED(hr))
    {
        goto done;
    }
    hr = pMediaType->SetGUID(MF_MT_MAJOR_TYPE, guidMajor);
    if (FAILED(hr))
    {
        goto done;
    }
    hr = pMediaType->SetGUID(MF_MT_SUBTYPE, MFVideoFormat_RGB32);
    if (FAILED(hr))
    {
        goto done;
    }
    hr = MFSetAttributeRatio(pMediaType, MF_MT_FRAME_RATE, fps.Numerator, fps.Denominator);
    if (FAILED(hr))
    {
        goto done;
    }
    hr = MFSetAttributeSize(pMediaType, MF_MT_FRAME_SIZE, width, height);
    if (FAILED(hr))
    {
        goto done;
    }
    hr = pMediaType->SetUINT32(MF_MT_INTERLACE_MODE, 2);
    if (FAILED(hr))
    {
        goto done;
    }

    hr = pMediaType->SetUINT32(MF_MT_ALL_SAMPLES_INDEPENDENT, TRUE);
    if (FAILED(hr))
    {
        goto done;
    }

    hr = pMediaType->SetUINT32(MF_MT_AVG_BITRATE, cBitrate);
    if (FAILED(hr))
    {
        goto done;
    }

    // Return the pointer to the caller.
    *ppMediaType = pMediaType;
    (*ppMediaType)->AddRef();


done:
    SafeRelease(&pMediaType);
    return hr;
}

次のコード例では、指定したビデオメディアの種類にコーデックプライベートデータを追加します。

//
// AddPrivateData
// Appends the private codec data to a media type.
//
// pMFT: The video encoder
// pTypeOut: A video type from the encoder's type list.
//
// The function modifies pTypeOut by adding the codec data.
//

HRESULT AddPrivateData(IMFTransform *pMFT, IMFMediaType *pTypeOut)
{
    HRESULT hr = S_OK;
    ULONG cbData = 0;
    BYTE *pData = NULL;

    IWMCodecPrivateData *pPrivData = NULL;

    DMO_MEDIA_TYPE mtOut = { 0 };

    // Convert the type to a DMO type.
    hr = MFInitAMMediaTypeFromMFMediaType(
        pTypeOut, 
        FORMAT_VideoInfo, 
        (AM_MEDIA_TYPE*)&mtOut
        );

    if (SUCCEEDED(hr))
    {
        hr = pMFT->QueryInterface(IID_PPV_ARGS(&pPrivData));
    }

    if (SUCCEEDED(hr))
    {
        hr = pPrivData->SetPartialOutputType(&mtOut);
    }

    //
    // Get the private codec data
    //

    // First get the buffer size.
    if (SUCCEEDED(hr))
    {
        hr = pPrivData->GetPrivateData(NULL, &cbData);
    }

    if (SUCCEEDED(hr))
    {
        pData = new BYTE[cbData];

        if (pData == NULL)
        {
            hr = E_OUTOFMEMORY;
        }
    }

    // Now get the data.
    if (SUCCEEDED(hr))
    {
        hr = pPrivData->GetPrivateData(pData, &cbData);
    }

    // Add the data to the media type.
    if (SUCCEEDED(hr))
    {
        hr = pTypeOut->SetBlob(MF_MT_USER_DATA, pData, cbData);
    }

    delete [] pData;
    MoFreeMediaType(&mtOut);
    SafeRelease(&pPrivData);
    return hr;
}

ASF ContentInfo オブジェクトを作成する

ASF ContentInfo オブジェクトは、主に ASF ヘッダーオブジェクト情報を格納するように設計された WMContainer レベルのコンポーネントです。 ASF ファイルシンクは、エンコードされたファイルの ASF ヘッダーオブジェクトの書き込みに使用される情報を (プロパティストアに) 格納するために ContentInfo オブジェクトを実装します。そのためには、エンコードセッションを開始する前に、ContentInfo オブジェクトに関する次の一連の情報を作成して構成する必要があります。

MFCreateASFContentInfo を呼び出して、空の ContentInfo オブジェクトを作成します。

次のコード例では、空の ContentInfo オブジェクトを作成します。
```
    // Create an empty ContentInfo object
    hr = MFCreateASFContentInfo(&pContentInfo);
    if (FAILED(hr))
    {
        goto done;
    }
```
IMFASFContentInfo::GetEncodingConfigurationPropertyStore を呼び出して、ファイルシンクのストリームレベルのプロパティストアを取得します。この呼び出しでは、ASF プロファイルの作成時にストリームに割り当てたストリーム番号を渡す必要があります。

ファイルシンクのストリームプロパティストアで、ストリームレベルのエンコードプロパティを設定します。詳細については、「ファイルシンクのプロパティの設定」の「ストリームエンコードプロパティ」を参照してください。

次のコード例では、ファイルシンクのプロパティストアでストリームレベルのプロパティを設定します。

        //Get stream's encoding property
        hr = pContentInfo->GetEncodingConfigurationPropertyStore(wStreamID, &pContentInfoProps);
        if (FAILED(hr))
        {
            goto done;
        }

        //Set the stream-level encoding properties
        hr = SetEncodingProperties(guidMajor, pContentInfoProps);       
        if (FAILED(hr))
        {
            goto done;
        }

次のコード例では、SetEncodingProperties の実装を示しています。この関数は、CBR および VBR のストリームレベルのエンコードプロパティを設定します。

//-------------------------------------------------------------------
//  SetEncodingProperties
//  Create a media source from a URL.
//
//  guidMT:  Major type of the stream, audio or video
//  pProps:  A pointer to the property store in which 
//           to set the required encoding properties.
//-------------------------------------------------------------------

HRESULT SetEncodingProperties (const GUID guidMT, IPropertyStore* pProps)
{
    if (!pProps)
    {
        return E_INVALIDARG;
    }

    if (EncodingMode == NONE)
    {
        return MF_E_NOT_INITIALIZED;
    }

    HRESULT hr = S_OK;

    PROPVARIANT var;

    switch (EncodingMode)
    {
        case CBR:
            // Set VBR to false.
            hr = InitPropVariantFromBoolean(FALSE, &var);
            if (FAILED(hr))
            {
                goto done;
            }

            hr = pProps->SetValue(MFPKEY_VBRENABLED, var);
            if (FAILED(hr))
            {
                goto done;
            }

            // Set the video buffer window.
            if (guidMT == MFMediaType_Video)
            {
                hr = InitPropVariantFromInt32(VIDEO_WINDOW_MSEC, &var);
                if (FAILED(hr))
                {
                    goto done;
                }

                hr = pProps->SetValue(MFPKEY_VIDEOWINDOW, var);    
                if (FAILED(hr))
                {
                    goto done;
                }
            }
            break;

        case VBR:
            //Set VBR to true.
            hr = InitPropVariantFromBoolean(TRUE, &var);
            if (FAILED(hr))
            {
                goto done;
            }

            hr = pProps->SetValue(MFPKEY_VBRENABLED, var);
            if (FAILED(hr))
            {
                goto done;
            }

            // Number of encoding passes is 1.

            hr = InitPropVariantFromInt32(1, &var);
            if (FAILED(hr))
            {
                goto done;
            }

            hr = pProps->SetValue(MFPKEY_PASSESUSED, var);
            if (FAILED(hr))
            {
                goto done;
            }

            // Set the quality level.

            if (guidMT == MFMediaType_Audio)
            {
                hr = InitPropVariantFromUInt32(98, &var);
                if (FAILED(hr))
                {
                    goto done;
                }

                hr = pProps->SetValue(MFPKEY_DESIRED_VBRQUALITY, var);    
                if (FAILED(hr))
                {
                    goto done;
                }
            }
            else if (guidMT == MFMediaType_Video)
            {
                hr = InitPropVariantFromUInt32(95, &var);
                if (FAILED(hr))
                {
                    goto done;
                }

                hr = pProps->SetValue(MFPKEY_VBRQUALITY, var);    
                if (FAILED(hr))
                {
                    goto done;
                }
            }
            break;

        default:
            hr = E_UNEXPECTED;
            break;
    }    

done:
    PropVariantClear(&var);
    return hr;
}

IMFASFContentInfo::GetEncodingConfigurationPropertyStore を呼び出して、ファイルシンクのグローバルプロパティストアを取得します。この呼び出しでは、最初のパラメーターに 0 を渡す必要があります。詳細については、「ファイルシンクのプロパティの設定」の「グローバルファイルシンクのプロパティ」を参照してください。
ASF マルチプレクサーの漏れバケット値が適切に調整されるように、MFPKEY_ASFMEDIASINK_AUTOADJUST_BITRATE を VARIANT_TRUE に設定します。このプロパティの詳細については、「マルチプレクサーオブジェクトの作成」の「マルチプレクサーの初期化と漏れバケット設定」を参照してください。

次のコード例では、ファイルシンクのプロパティストアでストリームレベルのプロパティを設定します。
```
    //Now we need to set global properties that will be set on the media sink
    hr = pContentInfo->GetEncodingConfigurationPropertyStore(0, &pContentInfoProps);
    if (FAILED(hr))
    {
        goto done;
    }

    //Auto adjust Bitrate
    var.vt = VT_BOOL;
    var.boolVal = VARIANT_TRUE;

    hr = pContentInfoProps->SetValue(MFPKEY_ASFMEDIASINK_AUTOADJUST_BITRATE, var);

    //Initialize with the profile
    hr = pContentInfo->SetProfile(pProfile);
    if (FAILED(hr))
    {
        goto done;
    }
```
Note

この他にも、ファイルシンクのグローバルレベルで設定できるプロパティがあります。詳細については、「ContentInfo オブジェクトのプロパティの設定」の「エンコーダー設定を使用した ContentInfo オブジェクトの構成」を参照してください。

構成された ASF ContentInfo を使用して、ASF ファイルシンクのアクティブ化オブジェクトを作成します (次のセクションで説明します)。

アウトプロセスファイルシンク (MFCreateASFMediaSinkActivate) を作成する場合は、アクティブ化オブジェクトを使用して、構成された ContentInfo オブジェクトを使用して ASF メディアシンクをインスタンス化できます (次のセクションで説明します)。手順 1 で説明したとおり、空の ContentInfo オブジェクトを作成するのではなく、インプロセスファイルシンク (MFCreateASFMediaSink) を作成する場合は、ファイルシンクで IMFMediaSink::QueryInterface を呼び出して、IMFASFContentInfo インターフェイスへの参照を取得します。次に、このセクションの説明に従って ContentInfo オブジェクトを構成する必要があります。

ASF ファイルシンクを作成する

チュートリアルのこの手順では、前の手順で作成した構成済みの ASF ContentInfo を使用して、MFCreateASFMediaSinkActivate 関数を呼び出して ASF ファイルシンクのアクティブ化オブジェクトを作成します。詳細については、「ASFファイルシンクの作成」を参照してください。

次のコード例では、ファイルシンクのアクティブ化オブジェクトを作成します。

    //Create the activation object for the  file sink
    hr = MFCreateASFMediaSinkActivate(sURL, pContentInfo, &pActivate);
    if (FAILED(hr))
    {
        goto done;
    }

部分エンコードトポロジを構築する

次に、メディアソース、必要な Windows Media エンコーダー、ASF ファイルシンクのトポロジノードを作成して、部分エンコードトポロジを構築します。トポロジノードを追加した後、ソース、変換、シンクノードを接続します。トポロジノードを追加する前に、MFCreateTopology を呼び出して空のトポロジオブジェクトを作成する必要があります。

メディアソースのソーストポロジノードを作成する

この手順では、メディアソースのソーストポロジノードを作成します。

このノードを作成するには、次の参照が必要です。

このチュートリアルの「メディアソースを作成する」セクションで説明されている手順で作成したメディアソースへのポインター。
メディアソースのプレゼンテーション記述子へのポインター。 IMFMediaSource::CreatePresentationDescriptor を呼び出すことで、メディアソースの IMFPresentationDescriptor インターフェイスへの参照を取得できます。
このチュートリアルの「ASF プロファイルオブジェクトを作成する」セクションで説明されている手順でターゲットストリームを作成したメディアソース内の各ストリームのストリーム記述子へのポインター。

ソースノードの作成とコード例の詳細については、「ソースノードの作成」を参照してください。

次のコード例では、ソースノードと必要な変換ノードを追加して、部分トポロジを作成します。このコードは、ヘルパー関数の AddSourceNode と AddTransformOutputNodes を呼び出します。これらの関数については、このチュートリアル内で後述しています。

//-------------------------------------------------------------------
//  BuildPartialTopology
//  Create a partial encoding topology by adding the source and the sink.
//
//  pSource:  A pointer to the media source to enumerate the source streams.
//  pSinkActivate: A pointer to the activation object for ASF file sink.
//  ppTopology:  Receives a pointer to the topology.
//-------------------------------------------------------------------

HRESULT BuildPartialTopology(
       IMFMediaSource *pSource, 
       IMFActivate* pSinkActivate,
       IMFTopology** ppTopology)
{
    if (!pSource || !pSinkActivate)
    {
        return E_INVALIDARG;
    }
    if (!ppTopology)
    {
        return E_POINTER;
    }

    HRESULT hr = S_OK;

    IMFPresentationDescriptor* pPD = NULL;
    IMFStreamDescriptor *pStreamDesc = NULL;
    IMFMediaTypeHandler* pMediaTypeHandler = NULL;
    IMFMediaType* pSrcType = NULL;

    IMFTopology* pTopology = NULL;
    IMFTopologyNode* pSrcNode = NULL;
    IMFTopologyNode* pEncoderNode = NULL;
    IMFTopologyNode* pOutputNode = NULL;


    DWORD cElems = 0;
    DWORD dwSrcStream = 0;
    DWORD StreamID = 0;
    GUID guidMajor = GUID_NULL;
    BOOL fSelected = FALSE;


    //Create the topology that represents the encoding pipeline
    hr = MFCreateTopology (&pTopology);
    if (FAILED(hr))
    {
        goto done;
    }

        
    hr = pSource->CreatePresentationDescriptor(&pPD);
    if (FAILED(hr))
    {
        goto done;
    }

    hr = pPD->GetStreamDescriptorCount(&dwSrcStream);
    if (FAILED(hr))
    {
        goto done;
    }

    for (DWORD iStream = 0; iStream < dwSrcStream; iStream++)
    {
        hr = pPD->GetStreamDescriptorByIndex(
            iStream, &fSelected, &pStreamDesc);
        if (FAILED(hr))
        {
            goto done;
        }

        if (!fSelected)
        {
            continue;
        }

        hr = AddSourceNode(pTopology, pSource, pPD, pStreamDesc, &pSrcNode);
        if (FAILED(hr))
        {
            goto done;
        }

        hr = pStreamDesc->GetMediaTypeHandler (&pMediaTypeHandler);
        if (FAILED(hr))
        {
            goto done;
        }
        
        hr = pStreamDesc->GetStreamIdentifier(&StreamID);
        if (FAILED(hr))
        {
            goto done;
        }

        hr = pMediaTypeHandler->GetMediaTypeByIndex(0, &pSrcType);
        if (FAILED(hr))
        {
            goto done;
        }

        hr = pSrcType->GetMajorType(&guidMajor);
        if (FAILED(hr))
        {
            goto done;
        }

        hr = AddTransformOutputNodes(pTopology, pSinkActivate, pSrcType, &pEncoderNode);
        if (FAILED(hr))
        {
            goto done;
        }

        //now we have the transform node, connect it to the source node
        hr = pSrcNode->ConnectOutput(0, pEncoderNode, 0);
        if (FAILED(hr))
        {
            goto done;
        }
                

        SafeRelease(&pStreamDesc);
        SafeRelease(&pMediaTypeHandler);
        SafeRelease(&pSrcType);
        SafeRelease(&pEncoderNode);
        SafeRelease(&pOutputNode);
        guidMajor = GUID_NULL;
    }

    *ppTopology = pTopology;
   (*ppTopology)->AddRef();


    wprintf_s(L"Partial Topology Built.\n");

done:
    SafeRelease(&pStreamDesc);
    SafeRelease(&pMediaTypeHandler);
    SafeRelease(&pSrcType);
    SafeRelease(&pEncoderNode);
    SafeRelease(&pOutputNode);
    SafeRelease(&pTopology);

    return hr;
}

次のコード例では、ソーストポロジノードを作成し、エンコードトポロジに追加します。これまでに作成したトポロジオブジェクト、ソースストリームを列挙するメディアソース、メディアソースのプレゼンテーション記述子、およびメディアソースのストリーム記述子へのポインターを受け取ります。呼び出し元は、ソーストポロジノードへのポインターを受け取ります。

// Add a source node to a topology.
HRESULT AddSourceNode(
    IMFTopology *pTopology,           // Topology.
    IMFMediaSource *pSource,          // Media source.
    IMFPresentationDescriptor *pPD,   // Presentation descriptor.
    IMFStreamDescriptor *pSD,         // Stream descriptor.
    IMFTopologyNode **ppNode)         // Receives the node pointer.
{
    IMFTopologyNode *pNode = NULL;

    // Create the node.
    HRESULT hr = MFCreateTopologyNode(MF_TOPOLOGY_SOURCESTREAM_NODE, &pNode);
    if (FAILED(hr))
    {
        goto done;
    }

    // Set the attributes.
    hr = pNode->SetUnknown(MF_TOPONODE_SOURCE, pSource);
    if (FAILED(hr))
    {
        goto done;
    }

    hr = pNode->SetUnknown(MF_TOPONODE_PRESENTATION_DESCRIPTOR, pPD);
    if (FAILED(hr))
    {
        goto done;
    }

    hr = pNode->SetUnknown(MF_TOPONODE_STREAM_DESCRIPTOR, pSD);
    if (FAILED(hr))
    {
        goto done;
    }
    
    // Add the node to the topology.
    hr = pTopology->AddNode(pNode);
    if (FAILED(hr))
    {
        goto done;
    }

    // Return the pointer to the caller.
    *ppNode = pNode;
    (*ppNode)->AddRef();

done:
    SafeRelease(&pNode);
    return hr;
}

必要なエンコーダーをインスタンス化し、変換ノードを作成する

メディアファンデーションパイプラインは、エンコードする必要があるストリームに必要な Windows Media エンコーダーを自動的に挿入しません。アプリケーションはエンコーダーを手動で追加する必要があります。これを行うには、このチュートリアルの「ASF プロファイルオブジェクトを作成する」セクションで説明されている手順で作成した ASF プロファイル内のストリームを列挙します。ソース内のストリームとプロファイル内の対応するストリームごとに、必要なエンコーダーをインスタンス化します。この手順では、このチュートリアルの「ASF ファイルシンクを作成する」セクションで説明されている手順で作成したファイルシンクのアクティブ化オブジェクトへのポインターが必要になります。

アクティブ化オブジェクトを使用したエンコーダーの作成の概要については、「エンコーダーのアクティブ化オブジェクトの使用」を参照してください。

次の手順では、必要なエンコーダーをインスタンス化するために必要な手順について説明します。

ファイルシンクアクティブ化で IMFActivate::ActivateObject を呼び出し、QueryInterface を呼び出してファイルシンクから IMFASFContentInfo のクエリを実行することで、シンクの ContentInfo オブジェクトへの参照を取得します。
IMFASFContentInfo::GetProfile を呼び出して、ContentInfo オブジェクトに関連付けられている ASF プロファイルを取得します。
プロファイル内のストリームを列挙します。そのためには、ストリーム数と、各ストリームの IMFASFStreamConfig インターフェイスへの参照が必要です。

次のメソッドを呼び出します。
- IMFASFProfile::GetStreamCount
- IMFASFProfile::GetStream
各ストリームについて、メジャー型とストリームのエンコードプロパティを ContentInfo オブジェクトから取得します。

次のメソッドを呼び出します。
- IMFASFStreamConfig::GetMediaType
- IMFMediaType::GetMajorType
- IMFASFContentInfo::GetEncodingConfigurationPropertyStore
  
  この呼び出しには、IMFASFProfile::GetStream 呼び出しによって取得されたストリーム番号が必要です。
ストリーム、オーディオ、またはビデオの種類に応じて、MFCreateWMAEncoderActivate または MFCreateWMVEncoderActivate を呼び出して、エンコーダーのアクティブ化オブジェクトをインスタンス化します。

これらの関数を呼び出すには、次の参照が必要です。
- 前の手順で IMFASFStreamConfig::GetMediaType によって取得されたストリームのメディアの種類へのポインター。
- IMFASFContentInfo::GetEncodingConfigurationPropertyStore によって取得されたストリームのエンコードプロパティストアへのポインター。ポインターをプロパティストアへ渡すことで、ファイルシンクに設定されたストリームプロパティがエンコーダー MFT にコピーされます。
オーディオストリームの漏れバケットパラメーターを更新します。

MFCreateWMAEncoderActivate は、Windows Media オーディオコーデックの基になるエンコーダー MFT に出力の種類を設定します。出力メディアの種類が設定されると、エンコーダーは出力メディアの種類から平均ビットレートを取得し、バッファーウィンドウを計算し、エンコードセッション中に使用される漏れバケット値を設定します。エンコーダーに対してクエリを実行するか、カスタム値を設定することで、ファイルシンク内のこれらの値を更新できます。値を更新するには、次の一連の情報が必要になります。
- 平均ビットレート: メディアタイプネゴシエーション中に選択された出力メディアの種類で設定された MF_MT_AUDIO_AVG_BYTES_PER_SECOND 属性から、平均ビットレートを取得します。
- バッファーウィンドウ: IWMCodecLeakyBucket::GetBufferSizeBits を呼び出して取得します。
- 初期バッファーサイズ: 0 に設定します。
DWORD の配列を作成し、オーディオストリームシンクの MFPKEY_ASFSTREAMSINK_CORRECTED_LEAKYBUCKET プロパティにその値を設定します。更新された値を指定しない場合、メディアセッションによって適切に設定されます。

詳細については、「漏れバケットバッファーモデル」を参照してください。

手順 5 で作成したアクティブ化オブジェクトは、変換トポロジノードとしてトポロジに追加する必要があります。詳細とコード例については、「変換ノードの作成」の「アクティブ化オブジェクトからの変換ノードの作成」を参照してください。

次のコード例では、必要なエンコーダーのアクティブ化を作成して追加します。これまでに作成したトポロジオブジェクト、ファイルシンクのアクティブ化オブジェクト、およびソースストリームのメディアの種類へのポインターを受け取ります。また、エンコードトポロジにシンクノードを作成して追加する AddOutputNode (次のコード例を参照) も呼び出します。呼び出し元は、ソーストポロジノードへのポインターを受け取ります。

//-------------------------------------------------------------------
//  AddTransformOutputNodes
//  Creates and adds the sink node to the encoding topology.
//  Creates and adds the required encoder activates.

//  pTopology:  A pointer to the topology.
//  pSinkActivate:  A pointer to the file sink's activation object.
//  pSourceType: A pointer to the source stream's media type.
//  ppNode:  Receives a pointer to the topology node.
//-------------------------------------------------------------------

HRESULT AddTransformOutputNodes(
    IMFTopology* pTopology,
    IMFActivate* pSinkActivate,
    IMFMediaType* pSourceType,
    IMFTopologyNode **ppNode    // Receives the node pointer.
    )
{
    if (!pTopology || !pSinkActivate || !pSourceType)
    {
        return E_INVALIDARG;
    }

    IMFTopologyNode* pEncNode = NULL;
    IMFTopologyNode* pOutputNode = NULL;
    IMFASFContentInfo* pContentInfo = NULL;
    IMFASFProfile* pProfile = NULL;
    IMFASFStreamConfig* pStream = NULL;
    IMFMediaType* pMediaType = NULL;
    IPropertyStore* pProps = NULL;
    IMFActivate *pEncoderActivate = NULL;
    IMFMediaSink *pSink = NULL; 

    GUID guidMT = GUID_NULL;
    GUID guidMajor = GUID_NULL;

    DWORD cStreams = 0;
    WORD wStreamNumber = 0;

    HRESULT hr = S_OK;
        
    hr = pSourceType->GetMajorType(&guidMajor);
    if (FAILED(hr))
    {
        goto done;
    }

    // Create the node.
    hr = MFCreateTopologyNode(MF_TOPOLOGY_TRANSFORM_NODE, &pEncNode);
    if (FAILED(hr))
    {
        goto done;
    }
    
    //Activate the sink
    hr = pSinkActivate->ActivateObject(__uuidof(IMFMediaSink), (void**)&pSink);
    if (FAILED(hr))
    {
        goto done;
    }
    //find the media type in the sink
    //Get content info from the sink
    hr = pSink->QueryInterface(__uuidof(IMFASFContentInfo), (void**)&pContentInfo);
    if (FAILED(hr))
    {
        goto done;
    }
    

    hr = pContentInfo->GetProfile(&pProfile);
    if (FAILED(hr))
    {
        goto done;
    }

    hr = pProfile->GetStreamCount(&cStreams);
    if (FAILED(hr))
    {
        goto done;
    }

    for(DWORD index = 0; index < cStreams ; index++)
    {
        hr = pProfile->GetStream(index, &wStreamNumber, &pStream);
        if (FAILED(hr))
        {
            goto done;
        }
        hr = pStream->GetMediaType(&pMediaType);
        if (FAILED(hr))
        {
            goto done;
        }
        hr = pMediaType->GetMajorType(&guidMT);
        if (FAILED(hr))
        {
            goto done;
        }
        if (guidMT!=guidMajor)
        {
            SafeRelease(&pStream);
            SafeRelease(&pMediaType);
            guidMT = GUID_NULL;

            continue;
        }
        //We need to activate the encoder
        hr = pContentInfo->GetEncodingConfigurationPropertyStore(wStreamNumber, &pProps);
        if (FAILED(hr))
        {
            goto done;
        }

        if (guidMT == MFMediaType_Audio)
        {
             hr = MFCreateWMAEncoderActivate(pMediaType, pProps, &pEncoderActivate);
            if (FAILED(hr))
            {
                goto done;
            }
            wprintf_s(L"Audio Encoder created. Stream Number: %d .\n", wStreamNumber);

            break;
        }
        if (guidMT == MFMediaType_Video)
        {
            hr = MFCreateWMVEncoderActivate(pMediaType, pProps, &pEncoderActivate);
            if (FAILED(hr))
            {
                goto done;
            }
            wprintf_s(L"Video Encoder created. Stream Number: %d .\n", wStreamNumber);

            break;
        }
    }

    // Set the object pointer.
    hr = pEncNode->SetObject(pEncoderActivate);
    if (FAILED(hr))
    {
        goto done;
    }

    // Add the node to the topology.
    hr = pTopology->AddNode(pEncNode);
    if (FAILED(hr))
    {
        goto done;
    }

    //Add the output node to this node.
    hr = AddOutputNode(pTopology, pSinkActivate, wStreamNumber, &pOutputNode);
    if (FAILED(hr))
    {
        goto done;
    }

    //now we have the output node, connect it to the transform node
    hr = pEncNode->ConnectOutput(0, pOutputNode, 0);
    if (FAILED(hr))
    {
        goto done;
    }

   // Return the pointer to the caller.
    *ppNode = pEncNode;
    (*ppNode)->AddRef();


done:
    SafeRelease(&pEncNode);
    SafeRelease(&pOutputNode);
    SafeRelease(&pEncoderActivate);
    SafeRelease(&pMediaType);
    SafeRelease(&pProps);
    SafeRelease(&pStream);
    SafeRelease(&pProfile);
    SafeRelease(&pContentInfo);
    SafeRelease(&pSink);
    return hr;
}

ファイルシンクの出力トポロジノードを作成する

この手順では、ASF ファイルシンクの出力トポロジノードを作成します。

このノードを作成するには、次の参照が必要です。

このチュートリアルの「ASF ファイルシンクを作成する」セクションで説明されている手順で作成したアクティブ化オブジェクトへのポインター。
ファイルシンクに追加されたストリームシンクを識別するストリーム番号。ストリーム番号は、ストリームの作成時に設定されたストリームの ID と一致します。

出力ノードの作成とコード例の詳細については、「出力ノードの作成」の「アクティブ化オブジェクトからの出力ノードの作成」を参照してください。

ファイルシンクにアクティブ化オブジェクトを使用していない場合は、ASF ファイルシンク内のストリームシンクを列挙し、各ストリームシンクをトポロジの出力ノードとして設定する必要があります。ストリームシンクの列挙については、「ASF ファイルシンクへのストリーム情報の追加」の「ストリームシンクの列挙」を参照してください。

次のコード例では、シンクノードを作成し、エンコードトポロジに追加します。これまでに作成したトポロジオブジェクト、ファイルシンクのアクティブ化オブジェクト、およびストリームの ID 番号へのポインターを受け取ります。呼び出し元は、ソーストポロジノードへのポインターを受け取ります。

// Add an output node to a topology.
HRESULT AddOutputNode(
    IMFTopology *pTopology,     // Topology.
    IMFActivate *pActivate,     // Media sink activation object.
    DWORD dwId,                 // Identifier of the stream sink.
    IMFTopologyNode **ppNode)   // Receives the node pointer.
{
    IMFTopologyNode *pNode = NULL;

    // Create the node.
    HRESULT hr = MFCreateTopologyNode(MF_TOPOLOGY_OUTPUT_NODE, &pNode);
    if (FAILED(hr))
    {
        goto done;
    }

    // Set the object pointer.
    hr = pNode->SetObject(pActivate);
    if (FAILED(hr))
    {
        goto done;
    }

    // Set the stream sink ID attribute.
    hr = pNode->SetUINT32(MF_TOPONODE_STREAMID, dwId);
    if (FAILED(hr))
    {
        goto done;
    }

    hr = pNode->SetUINT32(MF_TOPONODE_NOSHUTDOWN_ON_REMOVE, FALSE);
    if (FAILED(hr))
    {
        goto done;
    }

    // Add the node to the topology.
    hr = pTopology->AddNode(pNode);
    if (FAILED(hr))
    {
        goto done;
    }

    // Return the pointer to the caller.
    *ppNode = pNode;
    (*ppNode)->AddRef();

done:
    SafeRelease(&pNode);
    return hr;
}

次のコード例では、特定のメディアシンクのストリームシンクを列挙します。

//-------------------------------------------------------------------
//  EnumerateStreamSinks
//  Enumerates the stream sinks within the specified media sink.
//
//  pSink:  A pointer to the media sink.
//-------------------------------------------------------------------
HRESULT EnumerateStreamSinks (IMFMediaSink* pSink)
{
    if (!pSink)
    {
        return E_INVALIDARG;
    }
    
    IMFStreamSink* pStreamSink = NULL;
    DWORD cStreamSinks = 0;

    HRESULT hr = pSink->GetStreamSinkCount(&cStreamSinks);
    if (FAILED(hr))
    {
        goto done;
    }

    for(DWORD index = 0; index < cStreamSinks; index++)
    {
        hr = pSink->GetStreamSinkByIndex (index, &pStreamSink);
        if (FAILED(hr))
        {
            goto done;
        }

        //Use the stream sink
        //Not shown.
    }
done:
    SafeRelease(&pStreamSink);

    return hr;
}

ソースノード、変換ノード、シンクノードを接続する

この手順では、このチュートリアルの「必要なエンコーダーをインスタンス化し、変換ノードを作成する」セクションで説明されている手順で作成したエンコードアクティブ化を参照する変換ノードに、ソースノードを接続します。変換ノードは、ファイルシンクのアクティブ化オブジェクトを含む出力ノードに接続されます。

エンコードセッションを処理する

この手順では、以下の手順を実行します。

MFCreateMediaSession を呼び出して、エンコードセッションを作成します。
IMFMediaSession::SetTopology を呼び出して、セッションでエンコードトポロジを設定します。呼び出しが完了すると、メディアセッションはトポロジノードを評価し、エンコーダーへの入力としてフィードするために、指定された圧縮ソースを圧縮されていないサンプルに変換するデコーダーなどの追加の変換オブジェクトを挿入します。
IMFMediaSession::GetEvent を呼び出して、メディアセッションによって発生したイベントを要求します。

イベントループでは、メディアセッションによって発生したイベントに応じて、エンコードセッションを開始および終了します。 IMFMediaSession::SetTopology 呼び出しは、MF_TOPOSTATUS_READY フラグが設定された MESessionTopologyStatus イベントを発生させるメディアセッションになります。すべてのイベントは非同期的に生成され、アプリケーションはこれらのイベントを同期的または非同期的に取得できます。このチュートリアルのアプリケーションはコンソールアプリケーションであり、ユーザーインターフェイススレッドをブロックすることは問題ではないため、メディアセッションからイベントを同期的に取得します。

イベントを非同期的に取得するには、アプリケーションで IMFAsyncCallback インターフェイスを実装する必要があります。このインターフェイスの実装例と詳細については、「メディアファンデーションでメディアファイルを再生する方法」の「セッションイベントを処理する」を参照してください。

メディアセッションイベントを取得するためのイベントループで、IMFMediaSession::SetTopology が完了しトポロジが解決されたときに発生する、MESessionTopologyStatus イベントを待ちます。 MESessionTopologyStatus イベントを取得したら、IMFMediaSession::Start を呼び出してエンコードセッションを開始します。メディアセッションでは、すべてのエンコード操作が完了すると、MEEndOfPresentation イベントが生成されます。このイベントは VBR エンコードに対して処理される必要があり、このチュートリアルの次のセクション「VBR エンコード用のファイルシンクのエンコードプロパティを更新する」で説明します。

メディアセッションは ASF ヘッダーオブジェクトを生成し、エンコードセッションが完了したときにファイルを最終処理し、MESessionClosed イベントを発生させます。このイベントは、メディアセッションで適切なシャットダウン操作を実行して処理する必要があります。シャットダウン操作を開始するには、IMFMediaSession::Shutdown を呼び出します。エンコードセッションを閉じた後は、同じメディアセッションインスタンスで別のトポロジをエンコード用に設定することはできません。別のファイルをエンコードするには、現在のメディアセッションを閉じて解放し、新しく作成されたメディアセッションで新しいトポロジを設定する必要があります。次のコード例では、メディアセッションを作成し、エンコードトポロジを設定し、メディアセッションイベントを処理します。

次のコード例では、メディアセッションを作成し、エンコードトポロジを設定し、メディアセッションからのイベントを処理してエンコードセッションを制御します。

//-------------------------------------------------------------------
//  Encode
//  Controls the encoding session and handles events from the media session.
//
//  pTopology:  A pointer to the encoding topology.
//-------------------------------------------------------------------

HRESULT Encode(IMFTopology *pTopology)
{
    if (!pTopology)
    {
        return E_INVALIDARG;
    }
    
    IMFMediaSession *pSession = NULL;
    IMFMediaEvent* pEvent = NULL;
    IMFTopology* pFullTopology = NULL;
    IUnknown* pTopoUnk = NULL;


    MediaEventType meType = MEUnknown;  // Event type

    HRESULT hr = S_OK;
    HRESULT hrStatus = S_OK;            // Event status
                
    MF_TOPOSTATUS TopoStatus = MF_TOPOSTATUS_INVALID; // Used with MESessionTopologyStatus event.    
        

    hr = MFCreateMediaSession(NULL, &pSession);
    if (FAILED(hr))
    {
        goto done;
    }

    hr = pSession->SetTopology(MFSESSION_SETTOPOLOGY_IMMEDIATE, pTopology);
    if (FAILED(hr))
    {
        goto done;
    }

    //Get media session events synchronously
    while (1)
    {
        hr = pSession->GetEvent(0, &pEvent);
        if (FAILED(hr))
        {
            goto done;
        }

        hr = pEvent->GetType(&meType);
        if (FAILED(hr))
        {
            goto done;
        }

        hr = pEvent->GetStatus(&hrStatus);
        if (FAILED(hr))
        {
            goto done;
        }
        if (FAILED(hrStatus))
        {
            hr = hrStatus;
            goto done;
        }

       switch(meType)
        {
            case MESessionTopologyStatus:
                {
                    // Get the status code.
                    MF_TOPOSTATUS status = (MF_TOPOSTATUS)MFGetAttributeUINT32(
                                             pEvent, MF_EVENT_TOPOLOGY_STATUS, MF_TOPOSTATUS_INVALID);

                    if (status == MF_TOPOSTATUS_READY)
                    {
                        PROPVARIANT var;
                        PropVariantInit(&var);
                        wprintf_s(L"Topology resolved and set on the media session.\n");

                        hr = pSession->Start(NULL, &var);
                        if (FAILED(hr))
                        {
                            goto done;
                        }

                    }
                    if (status == MF_TOPOSTATUS_STARTED_SOURCE)
                    {
                        wprintf_s(L"Encoding started.\n");
                        break;
                    }
                    if (status == MF_TOPOSTATUS_ENDED)
                    {
                        wprintf_s(L"Encoding complete.\n");
                        hr = pSession->Close();
                        if (FAILED(hr))
                        {
                            goto done;
                        }

                        break;
                    }
                }
                break;


            case MESessionEnded:
                wprintf_s(L"Encoding complete.\n");
                hr = pSession->Close();
                if (FAILED(hr))
                {
                    goto done;
                }
                break;

            case MEEndOfPresentation:
                {
                    if (EncodingMode == VBR)
                    {
                        hr = pSession->GetFullTopology(MFSESSION_GETFULLTOPOLOGY_CURRENT, 0, &pFullTopology);
                        if (FAILED(hr))
                        {
                            goto done;
                        }
                        hr = PostEncodingUpdate(pFullTopology);
                        if (FAILED(hr))
                        {
                            goto done;
                        }
                        wprintf_s(L"Updated sinks for VBR. \n");
                    }
                }
                break;

            case MESessionClosed:
                wprintf_s(L"Encoding session closed.\n");

                hr = pSession->Shutdown();
                goto done;
        }
        if (FAILED(hr))
        {
            goto done;
        }

        SafeRelease(&pEvent);

    }
done:
    SafeRelease(&pEvent);
    SafeRelease(&pSession);
    SafeRelease(&pFullTopology);
    SafeRelease(&pTopoUnk);
    return hr;
}

ファイルシンクのエンコードプロパティを更新する

エンコードビットレートや正確な漏れバケット値などの特定のエンコードプロパティは、エンコードが完了するまで認識されません (特に VBR エンコードの場合)。正しい値を取得するには、アプリケーションは、エンコードセッションが完了したことを示す MEEndOfPresentation イベントを待つ必要があります。漏れバケット値は、ASF ヘッダーオブジェクトが正確な値を反映できるように、シンクで値を更新する必要があります。

次の手順では、エンコードトポロジ内のノードを走査してファイルシンクノードを取得し、必要な漏れバケットのプロパティを設定するために必要な手順について説明します。

ASF ファイルシンクのエンコード後のプロパティ値を更新するには

IMFTopology::GetOutputNodeCollection を呼び出して、エンコードトポロジから出力ノードコレクションを取得します。
ノードごとに、IMFTopologyNode::GetObject を呼び出してノード内のストリームシンクへのポインターを取得します。 IMFTopologyNode::GetObject によって返される IUnknown ポインターの IMFStreamSink インターフェイスのクエリを実行します。
ストリームシンクごとに、IMFTopologyNode::GetInput を呼び出してダウンストリームノード (エンコーダー) を取得します。
ノードにクエリを実行して、エンコーダーノードから IMFTransform ポインターを取得します。
エンコーダーに IPropertyStore ポインターのクエリを実行して、エンコーダーからエンコードプロパティストアを取得します。
ストリームシンクに IPropertyStore ポインターのクエリを実行して、ストリームシンクのプロパティストアを取得します。
IPropertyStore::GetValue を呼び出してエンコーダーのプロパティストアから必要なプロパティ値を取得し、IPropertyStore::SetValue を呼び出してストリームシンクのプロパティストアにコピーします。

次の表は、ビデオストリームのストリームシンクで設定する必要があるエンコード後のプロパティ値を示しています。

エンコードの種類	プロパティ名 (GetValue)	プロパティ名 (SetValue)
定数ビットレートエンコード	MFPKEY_BAVG MFPKEY_RAVG	MFPKEY_STAT_BAVG MFPKEY_STAT_RAVG
品質ベースの可変ビットレートエンコード	MFPKEY_BAVG MFPKEY_RAVG MFPKEY_BMAX MFPKEY_RMAX	MFPKEY_STAT_BAVG MFPKEY_STAT_RAVG MFPKEY_STAT_BMAX MFPKEY_STAT_RMAX

次のコード例では、エンコード後のプロパティ値を設定します。

//-------------------------------------------------------------------
//  PostEncodingUpdate
//  Updates the file sink with encoding properties set on the encoder
//  during the encoding session.
    //1. Get the output nodes
    //2. For each node, get the downstream node
    //3. For the downstream node, get the MFT
    //4. Get the property store
    //5. Get the required values
    //6. Set them on the stream sink
//
//  pTopology: A pointer to the full topology retrieved from the media session.
//-------------------------------------------------------------------

HRESULT PostEncodingUpdate(IMFTopology *pTopology)
{
    if (!pTopology)
    {
        return E_INVALIDARG;
    }

    HRESULT hr = S_OK;

    IMFCollection* pOutputColl = NULL;
    IUnknown* pNodeUnk = NULL;
    IMFMediaType* pType = NULL;
    IMFTopologyNode* pNode = NULL;
    IUnknown* pSinkUnk = NULL;
    IMFStreamSink* pStreamSink = NULL;
    IMFTopologyNode* pEncoderNode = NULL;
    IUnknown* pEncoderUnk = NULL;
    IMFTransform* pEncoder = NULL;
    IPropertyStore* pStreamSinkProps = NULL;
    IPropertyStore* pEncoderProps = NULL;

    GUID guidMajorType = GUID_NULL;

    PROPVARIANT var;
    PropVariantInit( &var );

    DWORD cElements = 0;

    hr = pTopology->GetOutputNodeCollection( &pOutputColl);
    if (FAILED(hr))
    {
        goto done;
    }


    hr = pOutputColl->GetElementCount(&cElements);
    if (FAILED(hr))
    {
        goto done;
    }


    for(DWORD index = 0; index < cElements; index++)
    {
        hr = pOutputColl->GetElement(index, &pNodeUnk);
        if (FAILED(hr))
        {
            goto done;
        }

        hr = pNodeUnk->QueryInterface(IID_IMFTopologyNode, (void**)&pNode);
        if (FAILED(hr))
        {
            goto done;
        }

        hr = pNode->GetInputPrefType(0, &pType);
        if (FAILED(hr))
        {
            goto done;
        }

        hr = pType->GetMajorType( &guidMajorType );
        if (FAILED(hr))
        {
            goto done;
        }

        hr = pNode->GetObject(&pSinkUnk);
        if (FAILED(hr))
        {
            goto done;
        }

        hr = pSinkUnk->QueryInterface(IID_IMFStreamSink, (void**)&pStreamSink);
        if (FAILED(hr))
        {
            goto done;
        }

        hr = pNode->GetInput( 0, &pEncoderNode, NULL );
        if (FAILED(hr))
        {
            goto done;
        }

        hr = pEncoderNode->GetObject(&pEncoderUnk);
        if (FAILED(hr))
        {
            goto done;
        }

        hr = pEncoderUnk->QueryInterface(IID_IMFTransform, (void**)&pEncoder);
        if (FAILED(hr))
        {
            goto done;
        }

        hr = pStreamSink->QueryInterface(IID_IPropertyStore, (void**)&pStreamSinkProps);
        if (FAILED(hr))
        {
            goto done;
        }

        hr = pEncoder->QueryInterface(IID_IPropertyStore, (void**)&pEncoderProps);
        if (FAILED(hr))
        {
            goto done;
        }

        if( guidMajorType == MFMediaType_Video )
        {            
            hr = pEncoderProps->GetValue( MFPKEY_BAVG, &var );
            if (FAILED(hr))
            {
                goto done;
            }
            hr = pStreamSinkProps->SetValue( MFPKEY_STAT_BAVG, var );
            if (FAILED(hr))
            {
                goto done;
            }

            PropVariantClear( &var );
            hr = pEncoderProps->GetValue( MFPKEY_RAVG, &var );
            if (FAILED(hr))
            {
                goto done;
            }
            hr = pStreamSinkProps->SetValue( MFPKEY_STAT_RAVG, var);
            if (FAILED(hr))
            {
                goto done;
            }

            PropVariantClear( &var );
            hr = pEncoderProps->GetValue( MFPKEY_BMAX, &var );
            if (FAILED(hr))
            {
                goto done;
            }
            hr = pStreamSinkProps->SetValue( MFPKEY_STAT_BMAX, var);
            if (FAILED(hr))
            {
                goto done;
            }

            PropVariantClear( &var );
            hr = pEncoderProps->GetValue( MFPKEY_RMAX, &var );
            if (FAILED(hr))
            {
                goto done;
            }
            hr = pStreamSinkProps->SetValue( MFPKEY_STAT_RMAX, var);
            if (FAILED(hr))
            {
                goto done;
            }
        }
        else if( guidMajorType == MFMediaType_Audio )
        {      
            hr = pEncoderProps->GetValue( MFPKEY_STAT_BAVG, &var );
            if (FAILED(hr))
            {
                goto done;
            }
            hr = pStreamSinkProps->SetValue( MFPKEY_STAT_BAVG, var );
            if (FAILED(hr))
            {
                goto done;
            }
            
            PropVariantClear( &var );
            hr = pEncoderProps->GetValue( MFPKEY_STAT_RAVG, &var );
            if (FAILED(hr))
            {
                goto done;
            }
            hr = pStreamSinkProps->SetValue( MFPKEY_STAT_RAVG, var );
            if (FAILED(hr))
            {
                goto done;
            }
            
            PropVariantClear( &var );
            hr = pEncoderProps->GetValue( MFPKEY_STAT_BMAX, &var);
            if (FAILED(hr))
            {
                goto done;
            }
            hr = pStreamSinkProps->SetValue( MFPKEY_STAT_BMAX, var);
            if (FAILED(hr))
            {
                goto done;
            }

            PropVariantClear( &var );
            hr = pEncoderProps->GetValue( MFPKEY_STAT_RMAX, &var );
            if (FAILED(hr))
            {
                goto done;
            }
            hr = pStreamSinkProps->SetValue( MFPKEY_STAT_RMAX, var );         
            if (FAILED(hr))
            {
                goto done;
            }

            PropVariantClear( &var );
            hr = pEncoderProps->GetValue( MFPKEY_WMAENC_AVGBYTESPERSEC, &var );
            if (FAILED(hr))
            {
                goto done;
            }
            hr = pStreamSinkProps->SetValue( MFPKEY_WMAENC_AVGBYTESPERSEC, var );         
            if (FAILED(hr))
            {
                goto done;
            }
        } 
        PropVariantClear( &var ); 
   }
done:
    SafeRelease (&pOutputColl);
    SafeRelease (&pNodeUnk);
    SafeRelease (&pType);
    SafeRelease (&pNode);
    SafeRelease (&pSinkUnk);
    SafeRelease (&pStreamSink);
    SafeRelease (&pEncoderNode);
    SafeRelease (&pEncoderUnk);
    SafeRelease (&pEncoder);
    SafeRelease (&pStreamSinkProps);
    SafeRelease (&pEncoderProps);

    return hr;
   
}

main を実装する

次のコード例は、コンソールアプリケーションの main 関数を示します。

int wmain(int argc, wchar_t* argv[])
{
    HeapSetInformation(NULL, HeapEnableTerminationOnCorruption, NULL, 0);

    if (argc != 4)
    {
        wprintf_s(L"Usage: %s inputaudio.mp3, %s output.wm*, %Encoding Type: CBR, VBR\n");
        return 0;
    }


    HRESULT             hr = S_OK;

    IMFMediaSource* pSource = NULL;
    IMFTopology* pTopology = NULL;
    IMFActivate* pFileSinkActivate = NULL;

    hr = CoInitializeEx(NULL, COINIT_APARTMENTTHREADED | COINIT_DISABLE_OLE1DDE);
    if (FAILED(hr))
    {
        goto done;
    }

    //Set the requested encoding mode
    if (wcscmp(argv[3], L"CBR")==0)
    {
        EncodingMode = CBR;
    }
    else if (wcscmp(argv[3], L"VBR")==0)
    {
        EncodingMode = VBR;
    }
    else
    {
        EncodingMode = CBR;
    }

    // Start up Media Foundation platform.
    hr = MFStartup(MF_VERSION);
    if (FAILED(hr))
    {
        goto done;
    }

    //Create the media source
    hr = CreateMediaSource(argv[1], &pSource);
    if (FAILED(hr))
    {
        goto done;
    }

    //Create the file sink activate
    hr = CreateMediaSink(argv[2], pSource, &pFileSinkActivate);
    if (FAILED(hr))
    {
        goto done;
    }

    //Build the encoding topology.
    hr = BuildPartialTopology(pSource, pFileSinkActivate, &pTopology);
    if (FAILED(hr))
    {
        goto done;
    }

    //Instantiate the media session and start encoding
    hr = Encode(pTopology);
    if (FAILED(hr))
    {
        goto done;
    }


done:
    // Clean up.
    SafeRelease(&pSource);
    SafeRelease(&pTopology);
    SafeRelease(&pFileSinkActivate);

    MFShutdown();
    CoUninitialize();

    if (FAILED(hr))
    {
        wprintf_s(L"Could not create the output file due to 0x%X\n", hr);
    }
    return 0;
}

出力ファイルをテストする

次の一覧は、エンコードされたファイルをテストするためのチェック項目になります。これらの値は、エンコードされたファイルを右クリックし、コンテキストメニューから [プロパティ] を選ぶことで表示できる、ファイルのプロパティダイアログボックスで確認できます。

エンコードされたファイルのパスが正しいことを確認します。
ファイルのサイズは 0 KB より大きく、再生時間はソースファイルの長さと一致することを確認します。
ビデオストリームの場合は、フレームの幅と高さ、フレームレートをチェックします。これらの値は、「ASF プロファイルオブジェクトを作成する」セクションで説明されている手順で作成した ASF プロファイルで指定した値と一致する必要があります。
オーディオストリームの場合は、ビットレートはターゲットメディアの種類で指定した値に近い値である必要があります。
Windows Media Player でファイルを開き、エンコードの品質をチェックします。
ASFViewer で ASF ファイルを開き、ASF ファイルの構造を確認します。このツールは、この Microsoft Web サイトからダウンロードできます。

一般的なエラーコードとデバッグのヒント

次の一覧は、受け取る可能性がある一般的なエラーコードとデバッグのヒントについて説明になります。

IMFSourceResolver::CreateObjectFromURL を呼び出すと、アプリケーションがストールします。

メディアファンデーションプラットフォームが MFStartup を呼び出して初期化されていることを確認します。この関数は、IMFSourceResolver::CreateObjectFromURL など、非同期操作を内部で開始するすべてのメソッドで使用される非同期プラットフォームを設定します。
IMFSourceResolver::CreateObjectFromURL が HRESULT 0x80070002 "指定されたファイルが見つかりません" を返します。

最初の引数でユーザーが指定した入力ファイル名が存在することを確認します。
HRESULT 0x80070020 "ファイルは別のプロセスで使用されているため、このプロセスからアクセスすることはできません。 "

入力ファイルと出力ファイルが、システム内の別のリソースによって現在使用されていないことを確認します。
IMFTransform メソッドの呼び出しが MF_E_INVALIDMEDIATYPE を返します。

次の条件が満たされていることを確認してください。
- 指定した入力の種類または出力の種類は、エンコーダーがサポートするメディアの種類と互換性があります。
- 指定したメディアの種類は完全です。メディアの種類を完全にするには、このチュートリアルの「圧縮オーディオメディアの種類を作成する」および「圧縮ビデオメディアの種類を作成する」セクションで必要な属性を参照してください。
- コーデックのプライベートデータを追加する部分的なメディアの種類でターゲットビットレートが設定されていることを確認します。
メディアセッションが、イベントの状態で MF_E_UNSUPPORTED_D3D_TYPE を返します。

このエラーは、ソースのメディアの種類が、Windows Media ビデオエンコーダーでサポートされていない混合インターレースモードを示している場合に返されます。圧縮ビデオメディアの種類がプログレッシブモードを使用するように設定されている場合は、パイプラインでインターレース解除変換を使用する必要があります。また、このエラーコードが示すように一致するものがパイプラインで見つからないため、インターレース解除 (ビデオプロセッサのトランスコード) をデコーダーノードとエンコーダーノードの間に手動で挿入する必要があります。
メディアセッションが、イベントの状態で E_INVALIDARG を返します。

このエラーは、ソースのメディアの種類の属性が、Windows Media エンコーダーに設定されている出力メディアの種類の属性と互換性がない場合に返されます。
IWMCodecPrivateData::GetPrivateData が、HRESULT 0x80040203 "クエリ文字列の評価中に構文エラーが発生しました" を返します。

エンコーダー MFT で入力の種類が設定されていることを確認します。

パイプラインレイヤーの ASF コンポーネント

チュートリアル: シングルパス Windows Media エンコード

前提条件

プロジェクトをセットアップする

メディアソースを作成する

ASF ファイルシンクを作成する

ASF プロファイルオブジェクトを作成する

圧縮オーディオメディアの種類を作成する

圧縮ビデオメディアの種類を作成する

ASF ContentInfo オブジェクトを作成する

ASF ファイルシンクを作成する

部分エンコードトポロジを構築する

メディアソースのソーストポロジノードを作成する

必要なエンコーダーをインスタンス化し、変換ノードを作成する

ファイルシンクの出力トポロジノードを作成する

ソースノード、変換ノード、シンクノードを接続する

エンコードセッションを処理する

ファイルシンクのエンコードプロパティを更新する

main を実装する

出力ファイルをテストする

一般的なエラーコードとデバッグのヒント

フィードバック

フィードバック

その他のリソース

チュートリアル: シングル パス Windows Media エンコード

前提条件

プロジェクトをセットアップする

メディア ソースを作成する

ASF ファイル シンクを作成する

ASF プロファイル オブジェクトを作成する

圧縮オーディオ メディアの種類を作成する

圧縮ビデオ メディアの種類を作成する

ASF ContentInfo オブジェクトを作成する

ASF ファイル シンクを作成する

部分エンコード トポロジを構築する

メディア ソースのソース トポロジ ノードを作成する

必要なエンコーダーをインスタンス化し、変換ノードを作成する

ファイル シンクの出力トポロジ ノードを作成する

ソース ノード、変換ノード、シンク ノードを接続する

エンコード セッションを処理する

ファイル シンクのエンコード プロパティを更新する

main を実装する

出力ファイルをテストする

一般的なエラー コードとデバッグのヒント

関連トピック

フィードバック

フィードバック

その他のリソース

チュートリアル: シングルパス Windows Media エンコード

メディアソースを作成する

ASF ファイルシンクを作成する

ASF プロファイルオブジェクトを作成する

圧縮オーディオメディアの種類を作成する

圧縮ビデオメディアの種類を作成する

ASF ファイルシンクを作成する

部分エンコードトポロジを構築する

メディアソースのソーストポロジノードを作成する

ファイルシンクの出力トポロジノードを作成する

ソースノード、変換ノード、シンクノードを接続する

エンコードセッションを処理する

ファイルシンクのエンコードプロパティを更新する

一般的なエラーコードとデバッグのヒント