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 格式，您必須為每個平面呼叫函式一次。 在此情況下， 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 |
| 程式庫 | Evr.lib |
| Dll | Mfplat.dll |