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

Статья
08/24/2023

Преобразует буфер мультимедиа Media Foundation в буфер, совместимый с объектами мультимедиа DirectX (DMOS).

Синтаксис

HRESULT MFCreateLegacyMediaBufferOnMFMediaBuffer(
  IMFSample      *pSample,
  IMFMediaBuffer *pMFMediaBuffer,
  DWORD          cbOffset,
  IMediaBuffer   **ppMediaBuffer
);

Параметры

pSample

Указатель на интерфейс IMFSample примера, содержащего буфер Media Foundation. Этот параметр может принимать значение NULL.

pMFMediaBuffer

Указатель на интерфейс IMFMediaBuffer буфера Media Foundation.

cbOffset

Смещение в байтах от начала буфера Media Foundation. Это смещение определяет, где начинается буфер DMO. Если этот параметр равен нулю, буфер DMO начинается в начале буфера Media Foundation.

ppMediaBuffer

Получает указатель на интерфейс IMediaBuffer . Этот интерфейс описан в документации по пакету SDK DirectShow. Вызывающий объект должен освободить интерфейс .

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

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

Код возврата	Описание
S_OK	Функция выполнена успешно.
E_INVALIDARG	Недопустимый аргумент. Параметр pIMFMediaBuffer не должен иметь значение NULL.

Буфер DMO, созданный этой функцией, также предоставляет интерфейс IMFSample . Если pIMFSample имеет значение NULL, все методы IMFSample возвращают MF_E_NOT_INITIALIZED. В противном случае они вызывают указатель pIMFSample .

Если буфер Media Foundation, заданный параметром pIMFMediaBuffer , предоставляет интерфейс IMF2DBuffer , буфер DMO также предоставляет значение IMF2DBuffer.

Требования


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