Поделиться через


Функция MFCreateMediaBufferWrapper (mfapi.h)

Создает буфер мультимедиа, который создает оболочку существующего буфера мультимедиа. Новый буфер мультимедиа указывает на ту же память, что и исходный буфер мультимедиа, или на смещение от начала памяти.

Синтаксис

HRESULT MFCreateMediaBufferWrapper(
  [in]  IMFMediaBuffer *pBuffer,
  [in]  DWORD          cbOffset,
  [in]  DWORD          dwLength,
  [out] IMFMediaBuffer **ppBuffer
);

Параметры

[in] pBuffer

Указатель на интерфейс IMFMediaBuffer исходного буфера мультимедиа.

[in] cbOffset

Начало нового буфера в виде смещения в байтах от начала исходного буфера.

[in] dwLength

Размер нового буфера. Значение cbOffset + dwLength должно быть меньше или равно размеру допустимых данных исходного буфера. (Размер допустимых данных возвращается методом IMFMediaBuffer::GetCurrentLength .)

[out] ppBuffer

Получает указатель на интерфейс IMFMediaBuffer . Вызывающий объект должен освободить интерфейс .

Возвращаемое значение

Функция возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата Описание
S_OK
Функция выполнена успешно.
E_INVALIDARG
Запрошенная смещение или запрошенная длина недопустимы.

Комментарии

Максимальный размер буфера-оболочки ограничен размером допустимых данных в исходном буфере. Это может быть меньше выделенного размера исходного буфера. Чтобы задать размер допустимых данных, вызовите IMFMediaBuffer::SetCurrentLength.

Эта функция доступна на следующих платформах, если установлены распространяемые компоненты пакета SDK для Windows Media Format 11:

  • Windows XP с пакетом обновления 2 (SP2) и более поздних версий.
  • Windows XP Media Center Edition 2005 с установленным KB900325 (Windows XP Media Center Edition 2005) и KB925766 (накопительный пакет обновления за октябрь 2006 г. для Windows XP Media Center Edition).

Требования

Требование Значение
Минимальная версия клиента Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header mfapi.h
Библиотека Mfplat.lib
DLL Mfplat.dll

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

Буферы мультимедиа

Функции Media Foundation