IMediaParams

IMediaParams インターフェイスは、オブジェクトのエンベロープ追従パラメーターを設定および取得します。

GetParam メソッドは、指定したパラメーターの現在の値を取得します。パラメーターが現在エンベロープセグメント内にある場合、最後に処理されたサンプルにおける値が返されます。

HRESULT 値を返します。取り得る値には次のものがあります。

このオブジェクトがサポートするパラメーターとそのインデックス値を列挙するには、IMediaParamInfo インターフェイスを使用します。

SetParam メソッドは、パラメーターの値を設定します。

HRESULT 値を返します。取り得る値には次のものがあります。

パラメーターが現在エンベロープセグメント内にある場合、エンベロープセグメントによって新しい値は上書きされます。エンベロープセグメントを削除するには、FlushEnvelope メソッドを呼び出します。

このオブジェクトがサポートするパラメーターとそのインデックス値を列挙するには、IMediaParamInfo インターフェイスを使用します。

AddEnvelope メソッドは、パラメーターにエンベロープを追加します。

HRESULT 値を返します。取り得る値には次のものがあります。

呼び出し側は、時間の昇順でエンベロープを追加する必要があります。そうしないと、再生時の結果は不定になります。あるエンベロープが別のエンベロープと重なる場合、後のエンベロープが優先されます。

このオブジェクトがサポートするパラメーターとそのインデックス値を列挙するには、IMediaParamInfo インターフェイスを使用します。

例

次のコードは、いずれも線形関数を使用する 2 つのエンベロープセグメントを設定します。

#define MSEC 10000  // One millisecond

// Define an array with two segments. Note the segments appear in 
// time-ascending order.
MP_ENVELOPE_SEGMENT Segments[] =
{
    {  
        0,                  // rtStart
        3 * MSEC,           // rtStop
        0,                  // valStart
        12,                 // valStop
        MP_CURVE_LINEAR,    // iCurve
        MPF_ENVLP_STANDARD  // flags
    },
    {  
        6 * MSEC,
        9 * MSEC,
        12,
        0,
        MP_CURVE_LINEAR,
        MPF_ENVLP_STANDARD
    }
};
// Define the number of segments in the array.
DWORD cSegments = sizeof(Segments) / sizeof(Segments[0]);
DWORD dwParam = 0;  // Which parameter to set.

hr = pMediaParams->AddEnvelope(dwParam, cSegments, Segments);

この例では、呼び出し側が事前に IMediaParamInfo インターフェイスを使用して、DMO が該当パラメーターに対して MP_CURVE_LINEAR カーブをサポートしているかどうかを照会済みであることを前提としています。

FlushEnvelope メソッドは、指定した時間範囲にわたって、指定したパラメーターのエンベロープデータをフラッシュします。

HRESULT 値を返します。取り得る値には次のものがあります。

refTimeStart と refTimeEnd で指定される時間範囲がエンベロープセグメントと重なる場合、そのセグメント全体がフラッシュされます。一方、範囲がエンベロープセグメントの境界上にある場合は、そのセグメント全体が保持されます。したがって、次のようになります。

• 開始時刻がエンベロープセグメント内にある場合、そのセグメントはフラッシュされます。
• 終了時刻がエンベロープセグメント内にある場合、そのセグメントはフラッシュされます。
• 開始時刻がエンベロープセグメントの終了時刻と等しい場合、そのセグメントは保持されます。
• 終了時刻がエンベロープセグメントの開始時刻と等しい場合、そのセグメントは保持されます。

SetTimeFormat メソッドは、オブジェクトの時間形式を指定します。

HRESULT 値を返します。取り得る値には次のものがあります。

オブジェクトは複数の時間形式をサポートできます。すべてのオブジェクトは、各時間単位が 100 ナノ秒 (ns) である参照時間をサポートする必要があります。その他の形式は任意です。アプリケーションは、入力バッファーのタイムスタンプが、このメソッドで設定した時間形式に一致するようにする必要があります。

mpTimeData パラメーターの意味は、guidTimeFormat パラメーターの値によって異なります。

このメソッドを呼び出すときは、FlushEnvelope メソッドも呼び出して、以前の時間形式で設定されたエンベロープをすべてフラッシュしてください。

オブジェクトがサポートする時間形式を確認するには、IMediaParamInfo::GetSupportedTimeFormat メソッドを呼び出します。現在の形式を取得するには、IMediaParamInfo::GetCurrentTimeFormat メソッドを呼び出します。