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 |