IMFMediaEngine::TransferVideoFrame メソッド (mfmediaengine.h)

現在のビデオ フレームを DXGI サーフェスまたは WIC ビットマップにコピーします。

構文

HRESULT TransferVideoFrame(
  [in] IUnknown                    *pDstSurf,
  [in] const MFVideoNormalizedRect *pSrc,
  [in] const RECT                  *pDst,
  [in] const MFARGB                *pBorderClr
);

パラメーター

[in] pDstSurf

宛先サーフェスの IUnknown インターフェイスへのポインター。

[in] pSrc

ソース四角形を指定する MFVideoNormalizedRect 構造体へのポインター。

[in] pDst

変換先の四角形を指定する RECT 構造体へのポインター。

[in] pBorderClr

罫線の色を指定する MFARGB 構造体へのポインター。

戻り値

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

フレーム サーバー モードでは、このメソッドを呼び出して、ビデオ フレームを DXGI または WIC サーフェスに blit します。 アプリケーションは、メディア エンジンがビデオ リソースを読み込んだ後、いつでもこのメソッドを呼び出すことができます。 ただし、通常、アプリケーションは最初 に IMFMediaEngine::OnVideoStreamTick を呼び出して、新しいフレームが使用可能かどうかを判断します。 OnVideoStreamTick がS_OKを返す場合、アプリケーションは TransferVideoFrame を呼び出します。

メディア エンジンは、ビデオを拡大/縮小し、変換先の四角形に合わせてレターボックスを設定します。 レターボックス領域に罫線の色が塗りつぶされます。

保護されたコンテンツの場合は、このメソッドの代わりに IMFMediaEngineProtectedContent::TransferVideoFrame メソッドを呼び出します。

要件

サポートされている最小のクライアント	Windows 8 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	mfmediaengine.h

関連項目

IMFMediaEngine