IDirectXVideoDecoder::BeginFrame メソッド (dxva2api.h)

デコード操作を開始します。

構文

HRESULT BeginFrame(
  [in] IDirect3DSurface9 *pRenderTarget,
  [in] void              *pvPVPData
);

[in] pRenderTarget

デコードされたフレームが書き込まれるレンダーターゲットの IDirect3DSurface9 インターフェイスへのポインター。

[in] pvPVPData

予約;NULL に設定 します。

このメソッドは HRESULT を返します。有効な値を次の表に示しますが、これ以外にもあります。

リターンコード	説明
S_OK	メソッドが成功しました。
E_INVALIDARG	無効なサーフェスの種類です。「解説」を参照してください。

このメソッドが呼び出されたら、 IDirectXVideoDecoder::Execute を呼び出してデコード操作を実行します。すべてのデコード操作が実行されたら、 IDirectXVideoDecoder::EndFrame を呼び出します。

BeginFrame の各呼び出しには EndFrame への一致する呼び出しが必要であり、BeginFrame 呼び出しを入れ子にすることはできません。

DXVA 1.0 移行注: バッファーをインデックスとして指定する IAMVideoAccelerator::BeginFrame メソッドとは異なり、このメソッドは非圧縮バッファーへのポインターを直接受け取ります。

pRenderTarget が指すサーフェスは、DxvaType の値をDXVA2_VideoDecoderRenderTargetして IDirectXVideoAccelerationService::CreateSurface を呼び出すことによって作成する必要があります。