IDMOVideoOutputOptimizations

IDMOVideoOutputOptimizations インターフェイスは、Microsoft DirectX Media Object (DMO) 上でのビデオ最適化をサポートします。

このインターフェイスにより、アプリケーションは DMO とビデオ出力の最適化についてネゴシエートできます。DMO は、アプリケーション側の対応が必要な最適化を実行できる場合に、このインターフェイスを公開します。アプリケーションは DMO に対して優先される機能を照会し、それを提供することに同意する (または同意しない) ことができます。アプリケーションが最適化を拒否した場合でも、DMO は出力を処理しなければなりません。

たとえば、ビデオデコーダーは、直前の出力フレームに差分を適用して出力フレームを生成することがあります。この場合、照会されると、直前のフレームを出力バッファーに与えるようアプリケーションに要求します。アプリケーションはこの要求に同意することも、しないこともできます。

ビデオ最適化は、出力ストリームごとに個別にネゴシエートされます。

次の擬似コードは、アプリケーションが DMO とネゴシエートする方法を示しています。

IDMOVideoOutputOptimizations *pVidOpt;
// Query the DMO for IDMOVideoOutputOptimizations (not shown).

BOOL  bWantsPreviousBuffer = FALSE;
DWORD wFlags;
pVidOpt->QueryOperationModePreferences(0,&dwFlags);

if (dwFlags & DMO_VOSF_NEEDS_PREVIOUS_SAMPLE) 
{
    // Agree to the request.      
    pVidOpt->SetOperationMode(0, DMO_VOSF_NEEDS_PREVIOUS_SAMPLE);
    bWantsPreviousBuffer = TRUE;
}

// Processing loop
while (there is input).
{
    ProcessInput(0, ...);
    if (bWantsPreviousBuffer)
        pDMO->ProcessOutput(0, ...) // Use the same buffer as last time.
    else
        pDMO->ProcessOutput(0, ...) // OK to use a new buffer.
}

QueryOperationModePreferences メソッドは、DMO が優先する最適化機能を取得します。

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

SetOperationMode メソッドは、有効になっている最適化機能を DMO に通知します。

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

このメソッドを呼び出す前に、IDMOVideoOutputOptimizations::QueryOperationModePreferences メソッドを呼び出して、DMO がどの機能を要求しているかを判断してください。その後、このメソッドを呼び出して、それらの機能のうちどれを提供するかを DMO に通知します。いずれの機能も提供しない場合は、このメソッドを呼び出す必要はありません。DMO は、それらの機能が提供されることを前提としません。

アプリケーションは、提供に同意したすべての機能を提供しなければなりません。ただし、一部の機能については、DMO がすべてのサンプルでその機能を必要とするとは限りません。次のサンプルで DMO がいずれかの機能を省略できるかどうかを判断するには、IDMOVideoOutputOptimizations::GetCurrentSampleRequirements メソッドを呼び出します。これにより、DMO は合意済みの機能を 1 つのサンプルに限って免除できます。

ストリーミングが開始される前は、このメソッドを再度呼び出すと以前の呼び出しが上書きされます。複数の機能を設定するには、1 回のメソッド呼び出しで行う必要があります。ストリーミングが開始された後は、このメソッドはエラーを返します。ストリーミングは、アプリケーションが少なくとも 1 つの入力ストリームに対して IMediaObject::ProcessInput を呼び出した時点で開始されます。

ストリーミングが終了すると、アプリケーションは機能を再ネゴシエートできます。ストリーミングは、アプリケーションが IMediaObject::Flush メソッドを呼び出した場合、またはすべての入力ストリームに対して IMediaObject::Discontinuity を呼び出し、残りの出力をすべて処理した場合に終了します。

GetCurrentOperationMode メソッドは、現在有効になっている最適化機能を取得します。

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

GetCurrentSampleRequirements メソッドは、アプリケーションが既に同意した機能を踏まえて、次のサンプルの処理に必要な最適化機能を取得します。

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

アプリケーションが IDMOVideoOutputOptimizations::SetOperationMode メソッドを呼び出した後は、同意したすべての機能を提供しなければなりません。ただし、DMO がすべてのサンプルであらゆる機能を必要とするとは限りません。このメソッドにより、DMO は合意済みの機能を 1 つのサンプルに限って免除できます。

アプリケーションは、サンプルを処理する前にこのメソッドを呼び出すことができます。DMO が次のサンプルを処理するうえで特定の機能を必要としない場合、DMO は pdwRequestedFeatures パラメーターから対応するフラグを除外します。アプリケーションは、次のサンプルに限りその機能を無視できます。このメソッドの結果は、次回の IMediaObject::ProcessOutput メソッドの呼び出しに対してのみ有効です。

DMO は、SetOperationMode メソッドで合意されたフラグのみを返します。言い換えると、このメソッドで新しい機能を動的に有効にすることはできません。