Interfaz IMFSample (mfobjects.h)

Representa un ejemplo multimedia, que es un objeto contenedor para los datos multimedia. En el caso del vídeo, un ejemplo normalmente contiene un fotograma de vídeo. En el caso de los datos de audio, un ejemplo normalmente contiene varias muestras de audio, en lugar de una sola muestra de audio.

Un ejemplo multimedia contiene cero o más búferes. Cada búfer administra un bloque de memoria y se representa mediante la interfaz IMFMediaBuffer . Un ejemplo puede tener varios búferes. Los búferes se mantienen en una lista ordenada y se accede a ellos por valor de índice. También es válido tener un ejemplo vacío sin búferes.

Herencia

La interfaz IMFSample hereda de IMFAttributes. IMFSample también tiene estos tipos de miembros:

Métodos

La interfaz IMFSample tiene estos métodos.

IMFSample::AddBuffer Agrega un búfer al final de la lista de búferes del ejemplo.
IMFSample::ConvertToContiguousBuffer Convierte un ejemplo con varios búferes en un ejemplo con un único búfer.
IMFSample::CopyToBuffer Copia los datos de ejemplo en un búfer. Este método concatena los datos válidos de todos los búferes del ejemplo, en orden.
IMFSample::GetBufferByIndex Obtiene un búfer del ejemplo, por índice.
IMFSample::GetBufferCount Recupera el número de búferes del ejemplo.
IMFSample::GetSampleDuration Recupera la duración del ejemplo.
IMFSample::GetSampleFlags Recupera marcas asociadas al ejemplo. Actualmente no se han definido marcas.
IMFSample::GetSampleTime Recupera el tiempo de presentación del ejemplo.
IMFSample::GetTotalLength Recupera la longitud total de los datos válidos en todos los búferes del ejemplo. La longitud se calcula como la suma de los valores recuperados por el método IMFMediaBuffer::GetCurrentLength.
IMFSample::RemoveAllBuffers Quita todos los búferes del ejemplo.
IMFSample::RemoveBufferByIndex Quita un búfer en un índice especificado del ejemplo.
IMFSample::SetSampleDuration Establece la duración del ejemplo.
IMFSample::SetSampleFlags Establece marcas asociadas al ejemplo. Actualmente no se han definido marcas.
IMFSample::SetSampleTime Establece el tiempo de presentación del ejemplo.

Comentarios

Para crear un nuevo ejemplo multimedia, llame a MFCreateSample.

Nota  

Cuando se llama a CopyAllItems, heredado de la interfaz IMFAttributes , en un IMFSample, el tiempo de muestra, la duración y las marcas no se copian en el ejemplo de destino. Debe copiar estos valores en el nuevo ejemplo manualmente.

 

Esta interfaz está disponible en las siguientes plataformas si se instalan los componentes redistribuibles del SDK de Windows Media Format 11:

• Windows XP con Service Pack 2 (SP2) y versiones posteriores.
• Windows XP Media Center Edition 2005 con KB900325 (Windows XP Media Center Edition 2005) y KB925766 (paquete acumulativo de actualizaciones de octubre de 2006 para Windows XP Media Center Edition) instalados.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	mfobjects.h (include Mfidl.h)

Consulte también

IMFAttributes

Interfaces de Media Foundation

Ejemplos de medios

Atributos de ejemplo