MFCopyImage 関数 (mfapi.h)

あるバッファーから別のバッファーにイメージまたはイメージ プレーンをコピーします。

構文

HRESULT MFCopyImage(
  [in] BYTE       *pDest,
  [in] LONG       lDestStride,
  [in] const BYTE *pSrc,
  [in] LONG       lSrcStride,
  [in] DWORD      dwWidthInBytes,
  [in] DWORD      dwLines
);

パラメーター

[in] pDest

コピー先バッファー内のピクセルの最初の行の先頭へのポインター。

[in] lDestStride

宛先バッファーのストライド (バイト単位)。

[in] pSrc

ソース イメージ内のピクセルの最初の行の先頭へのポインター。

[in] lSrcStride

ソース イメージのストライド (バイト単位)。

[in] dwWidthInBytes

イメージの幅 (バイト単位)。

[in] dwLines

コピーするピクセルの行数。

戻り値

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

注釈

この関数は、イメージの単一平面をコピーします。 平面 YUV 形式の場合は、平面ごとに関数を 1 回呼び出す必要があります。 この場合、 pDest と pSrc は 各平面の始点を指す必要があります。

この関数は、MMX、SSE、または SSE2 命令セットがプロセッサで使用可能な場合に最適化されます。 関数は非テンポラル ストアを実行します (データはキャッシュを汚染することなく直接メモリに書き込まれます)。

メモ Windows 7 より前のバージョンでは、この関数は evr.dll からエクスポートされていました。 Windows 7 以降では、この関数は mfplat.dll からエクスポートされ、evr.dll は mfplat.dll に呼び出すスタブ関数をエクスポートします。 詳細については、「 Windows 7 でのライブラリの変更」を参照してください。

 

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ | UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリ | UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	mfapi.h
Library	Evr.lib
[DLL]	Mfplat.dll

こちらもご覧ください

イメージ ストライド

メディア ファンデーション機能

メディアの種類