Função MFCreateLegacyMediaBufferOnMFMediaBuffer (mfapi.h)

Converte um buffer de mídia do Media Foundation em um buffer compatível com DMOs (DirectX Media Objects).

Sintaxe

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

Parâmetros

pSample

Ponteiro para a interface IMFSample do exemplo que contém o buffer do Media Foundation. Este parâmetro pode ser NULL.

pMFMediaBuffer

Ponteiro para a interface IMFMediaBuffer do buffer do Media Foundation.

cbOffset

Deslocamento em bytes desde o início do buffer do Media Foundation. Esse deslocamento define onde o buffer DMO é iniciado. Se esse parâmetro for zero, o buffer DMO será iniciado no início do buffer do Media Foundation.

ppMediaBuffer

Recebe um ponteiro para a interface IMediaBuffer . Essa interface está documentada na documentação do SDK do DirectShow. O chamador deve liberar a interface .

Valor retornado

A função retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
A função foi bem-sucedida.
E_INVALIDARG
Argumento inválido. O parâmetro pIMFMediaBuffer não deve ser NULL.

Comentários

O buffer DMO criado por essa função também expõe a interface IMFSample . Se pIMFSample for NULL, todos os métodos IMFSample retornarão MF_E_NOT_INITIALIZED. Caso contrário, eles chamam o ponteiro pIMFSample .

Se o buffer do Media Foundation especificado por pIMFMediaBuffer expor a interface IMF2DBuffer , o buffer DMO também exporá IMF2DBuffer.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mfapi.h
Biblioteca Mfplat.lib
DLL Mfplat.dll

Confira também

IMF2DBuffer

IMFMediaBuffer

IMFSample

Buffers de mídia

Funções do Media Foundation