Функция MFCopyImage (mfapi.h)

Статья
03/13/2024

Копирует изображение или плоскость изображения из одного буфера в другой.

Синтаксис

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
Header	mfapi.h
Библиотека	Evr.lib
DLL	Mfplat.dll

См. также раздел

Шаг изображения

Функции Media Foundation

Типы мультимедиа

Share via