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

Статья
08/24/2023

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

Синтаксис

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

Share via