コーデックメリット

[アーティクル]
03/12/2025

Windows 7 以降では、Media Foundation コーデックに メリット 値を割り当てることができます。コーデックを列挙する場合は、メリットの低いコーデックよりもメリットの高いコーデックが優先されます。メリット値を持つコーデックは、割り当てられたメリットのないコーデックよりも優先されます。コーデック列挙の詳細については、MFTEnumExを参照してください。

メリットの値は、Microsoft によって割り当てられます。現時点では、ハードウェアコーデックのみがメリット値を受け取る資格があります。コーデックベンダーには、コーデックのメリット値を検証するために使用されるデジタル証明書も発行されます。証明書を取得するには、wmla@microsoft.comに電子メール要求を送信します。証明書を取得するプロセスには、ライセンスに署名し、一連の情報ファイルを Microsoft に提供することが含まれます。

コーデックのメリットは次のように機能します。

コーデックベンダーは、次のいずれかを実装します。
- AVStream ミニドライバー。 Media Foundation は、AVStream ドライバー用の標準プロキシ MFT を提供します。これは推奨されるオプションです。
- ハードウェアへのプロキシとして機能する Media Foundation 変換 (MFT)。詳細については、ハードウェア MFT を参照してください。
コーデックのメリット値は、迅速な検索のためにレジストリに格納されます。
MFTEnumEx 関数は、メリットの順にコーデックを並べ替えます。メリット値を持つコーデックは、ローカルに登録されたコーデック (MFTRegisterLocalを参照) の背後にある一覧に表示されますが、他のコーデックよりも先に表示されます。
MFT が作成されると、Output Protection Manager (OPM) API を使用してコーデックのメリットが検証されます。
プロキシ MFT の場合、コーデックは IOPMVideoOutput インターフェイスを実装します。 AVStream ドライバーの場合、コーデックは KSPROPSETID_OPMVideoOutput プロパティセットを実装します。

次の図は、どちらの場合もメリットがどのように検証されるかを示しています。

2 つのプロセスを示す図:1 つはメディア基盤プロキシ mft と avstream ドライバーを通じて、もう 1 つはカスタムプロキシ mft

カスタムプロキシ MFT

ハードウェアコーデックのプロキシ MFT を指定する場合は、次のようにコーデックメリット値を実装します。

IOPMVideoOutput インターフェイスを MFT に実装します。コード例は、このトピックの次のセクションで示します。
次のように、MFT_CODEC_MERIT_Attribute 属性をレジストリに追加します。
1. MFCreateAttributes呼び出して、新しい属性ストアを作成します。
2. IMFAttributes::SetUINT32呼び出して、MFT_CODEC_MERIT_Attribute 属性を設定します。属性の値は、コーデックに割り当てられたメリットです。
3. MFTRegister呼び出して、MFT を登録します。 pAttributes パラメーターに属性ストアを渡します。
アプリケーションは MFTEnumEx呼び出します。この関数は、列挙条件 一致するコーデックごとに 1 つずつ、IMFActivate ポインターの配列を返します。
アプリケーションは、IMFActivate::ActivateObject呼び出して MFT を作成します。
ActivateObject メソッドは、MFGetMFTMerit 関数を呼び出して、証明書とメリット値を検証します。
MFGetMFTMerit 関数は IOPMVideoOutput::GetInformation呼び出し、OPM_GET_CODEC_INFO 状態要求を送信します。この状態要求は、コーデックの割り当てられたメリット値を返します。この値がレジストリ値と一致しない場合は、ActivateObject失敗する可能性があります。

次のコードは、MFT を登録するときにレジストリにメリット値を追加する方法を示しています。

// Shows how to register an MFT with a merit value.

HRESULT RegisterMFTWithMerit()
{
    // The following media types would apply to an H.264 decoder, 
    // and are used here as an example.

    MFT_REGISTER_TYPE_INFO aDecoderInputTypes[] = 
    {
        { MFMediaType_Video, MFVideoFormat_H264 },
    };

    MFT_REGISTER_TYPE_INFO aDecoderOutputTypes[] = 
    {
        { MFMediaType_Video, MFVideoFormat_RGB32 }
    };
    
    // Create an attribute store to hold the merit attribute.
    HRESULT hr = S_OK;
    IMFAttributes *pAttributes = NULL;

    hr = MFCreateAttributes(&pAttributes, 1);

    if (SUCCEEDED(hr))
    {
        hr = pAttributes->SetUINT32(
            MFT_CODEC_MERIT_Attribute, 
            DECODER_MERIT   // Use the codec's assigned merit value.
            );
    }

    // Register the decoder for MFTEnum(Ex).
    if (SUCCEEDED(hr))
    {
        hr = MFTRegister(
            CLSID_MPEG1SampleDecoder,                   // CLSID
            MFT_CATEGORY_VIDEO_DECODER,                 // Category
            const_cast<LPWSTR>(SZ_DECODER_NAME),        // Friendly name
            0,                                          // Flags
            ARRAYSIZE(aDecoderInputTypes),              // Number of input types
            aDecoderInputTypes,                         // Input types
            ARRAYSIZE(aDecoderOutputTypes),             // Number of output types
            aDecoderOutputTypes,                        // Output types
            pAttributes                                 // Attributes 
            );
    }

    SafeRelease(&pAttributes);
    return hr;
}