Función MFCreateSampleCopierMFT (mfidl.h)

  • Artículo

Crea una instancia de la transformación del copiador de ejemplo.

Sintaxis

HRESULT MFCreateSampleCopierMFT(
  [out] IMFTransform **ppCopierMFT
);

Parámetros

[out] ppCopierMFT

Recibe un puntero a la interfaz IMFTransform . El autor de la llamada debe liberar la interfaz .

Valor devuelto

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

El copiador de ejemplo es una transformación de Media Foundation (MFT) que copia datos de muestras de entrada a muestras de salida sin modificar los datos. Los datos siguientes se copian del ejemplo:

  • Todos los atributos de ejemplo.
  • Marca de tiempo y duración.
  • Marcas de ejemplo (vea IMFSample::SetSampleFlags).
  • Los datos de los búferes multimedia. Si el ejemplo de entrada contiene varios búferes, los datos se copian en un único búfer en el ejemplo de salida.
Este MFT es útil en la siguiente situación:
  • Un objeto de canalización, como un origen multimedia, asigna muestras de medios para la salida.
  • Otro objeto de canalización, como un receptor de medios, asigna sus propios ejemplos multimedia para la entrada. Por ejemplo, el objeto podría requerir búferes asignados desde un grupo de memoria especial, como la memoria de vídeo.
En el diagrama siguiente se muestra esta situación con un origen multimedia y un receptor de medios. Diagrama: El origen multimedia apunta a un ejemplo; Receptor de medios apunta a un segundo Ejemplo; Sample Copier apunta a una flecha del primer ejemplo al segundo

Para que el receptor de medios reciba datos del origen multimedia, los datos se deben copiar en las muestras de medios que pertenecen al receptor de medios. El copiador de ejemplo se puede usar para este fin.

Un ejemplo específico de este receptor de medios es Enhanced Video Renderer (EVR). El EVR asigna muestras que contienen búferes de superficie de Direct3D, por lo que no puede recibir muestras de vídeo directamente desde un origen multimedia. A partir de Windows 7, el cargador de topología controla automáticamente este caso insertando el copiador de ejemplo entre el origen multimedia y el EVR.

Requisitos

   
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mfidl.h
Library Mf.lib
Archivo DLL Mf.dll

Consulte también

Funciones de Media Foundation