Método IMFMediaEngine::TransferVideoFrame (mfmediaengine.h)

  • Artículo

Copia el fotograma de vídeo actual en una superficie DXGI o un mapa de bits WIC.

Sintaxis

HRESULT TransferVideoFrame(
  [in] IUnknown                    *pDstSurf,
  [in] const MFVideoNormalizedRect *pSrc,
  [in] const RECT                  *pDst,
  [in] const MFARGB                *pBorderClr
);

Parámetros

[in] pDstSurf

Puntero a la interfaz IUnknown de la superficie de destino.

[in] pSrc

Puntero a una estructura MFVideoNormalizedRect que especifica el rectángulo de origen.

[in] pDst

Puntero a una estructura RECT que especifica el rectángulo de destino.

[in] pBorderClr

Puntero a una estructura MFARGB que especifica el color del borde.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

En el modo de servidor de fotogramas, llame a este método para transferir el fotograma de vídeo a una superficie DXGI o WIC. La aplicación puede llamar a este método en cualquier momento después de que media Engine cargue un recurso de vídeo. Normalmente, sin embargo, la aplicación llama primero a IMFMediaEngine::OnVideoStreamTick para determinar si hay disponible un nuevo fotograma. Si OnVideoStreamTick devuelve S_OK, la aplicación llama a TransferVideoFrame.

El motor multimedia escala y los cuadros de letras del vídeo para ajustarse al rectángulo de destino. Rellena el área del cuadro de letras con el color del borde.

Para el contenido protegido, llame al método IMFMediaEngineProtectedContent::TransferVideoFrame en lugar de a este método.

Requisitos

   
Cliente mínimo compatible Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado mfmediaengine.h

Consulte también

IMFMediaEngine