Метод 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 .

Комментарии

В режиме frame-server вызовите этот метод, чтобы преобразовывать видеокадр на поверхность DXGI или WIC. Приложение может вызвать этот метод в любое время после того, как обработчик мультимедиа загрузит видеоресурс. Однако обычно приложение сначала вызывает IMFMediaEngine::OnVideoStreamTick , чтобы определить, доступен ли новый кадр. Если OnVideoStreamTick возвращает S_OK, приложение вызывает Метод TransferVideoFrame.

Обработчик мультимедиа масштабирует видео и помещает его в почтовые ящики в соответствии с прямоугольником назначения. Он заполняет область почтового ящика цветом границы.

Для защищенного содержимого вызовите метод IMFMediaEngineProtectedContent::TransferVideoFrame вместо этого метода.

Требования

   
Минимальная версия клиента Windows 8 [классические приложения | Приложения UWP]
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header mfmediaengine.h

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

IMFMediaEngine