Интерфейс IMFSample (mfobjects.h)

Представляет образец носителя, который является объектом контейнера для данных мультимедиа. Для видео пример обычно содержит один видеокадр. Для звуковых данных пример обычно содержит несколько образцов звука, а не один пример звука.

Пример носителя содержит ноль или больше буферов. Каждый буфер управляет блоком памяти и представлен интерфейсом IMFMediaBuffer . Пример может иметь несколько буферов. Буферы хранятся в упорядоченном списке и обращаются по значению индекса. Также допустимо иметь пустой образец без буферов.

Наследование

Интерфейс IMFSample наследует от МВФAttributes. МВФSample также имеет следующие типы членов:

Методы

Интерфейс IMFSample имеет эти методы.

 
IMFSample::AddBuffer

Добавляет буфер в конец списка буферов в образце.
IMFSample::ConvertToContiguousBuffer

Преобразует пример с несколькими буферами в образец с одним буфером.
IMFSample::CopyToBuffer

Копирует образец данных в буфер. Этот метод объединяет допустимые данные из всех буферов образца по порядку.
IMFSample::GetBufferByIndex

Получает буфер из примера по индексу.
IMFSample::GetBufferCount

Извлекает количество буферов в образце.
IMFSample::GetSampleDuration

Извлекает длительность примера.
IMFSample::GetSampleFlags

Извлекает флаги, связанные с примером. В настоящее время флаги не определены.
IMFSample::GetSampleTime

Извлекает время презентации примера.
IMFSample::GetTotalLength

Извлекает общую длину допустимых данных во всех буферах в образце. Длина вычисляется как сумма значений, полученных методом IMFMediaBuffer::GetCurrentLength.
IMFSample::RemoveAllBuffers

Удаляет все буферы из примера.
IMFSample::RemoveBufferByIndex

Удаляет буфер по указанному индексу из примера.
IMFSample::SetSampleDuration

Задает длительность примера.
IMFSample::SetSampleFlags

Задает флаги, связанные с примером. В настоящее время флаги не определены.
IMFSample::SetSampleTime

Задает время презентации примера.

Комментарии

Чтобы создать новый пример мультимедиа, вызовите MFCreateSample.

Примечание  

При вызове CopyAllItems, унаследованного от интерфейса IMFAttributes , в МВФSample выборка времени, длительности и флагов не копируются в целевой образец. Эти значения необходимо скопировать в новый пример вручную.

 
Этот интерфейс доступен на следующих платформах, если установлены распространяемые компоненты пакета SDK для Windows Media 11:
  • Windows XP с пакетом обновления 2 (SP2) и более поздними версиями.
  • Windows XP Media Center Edition 2005 с kb900325 (Windows XP Media Center Edition 2005) и KB9257666 (накопительный пакет обновления за октябрь 2006 г. для Windows XP Media Center Edition) установлен.

Требования

   
Минимальная версия клиента Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header mfobjects.h (включая Mfidl.h)

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

МВФAttributes

Интерфейсы Media Foundation

Примеры мультимедиа

Примеры атрибутов