Compartilhar via


Função MFCreateMemoryBuffer (mfapi.h)

Aloca memória do sistema e cria um buffer de mídia para gerenciá-la.

Sintaxe

HRESULT MFCreateMemoryBuffer(
  DWORD          cbMaxLength,
  IMFMediaBuffer **ppBuffer
);

Parâmetros

cbMaxLength

Tamanho do buffer, em bytes.

ppBuffer

Recebe um ponteiro para a interface IMFMediaBuffer do buffer de mídia. 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_OUTOFMEMORY
Memória insuficiente.

Comentários

A função aloca um buffer com um alinhamento de memória de 1 byte. Para alocar um buffer alinhado a um limite de memória maior, chame MFCreateAlignedMemoryBuffer.

Quando o objeto de buffer de mídia é destruído, ele libera a memória alocada.

Essa função estará disponível nas seguintes plataformas se os componentes redistribuíveis do SDK do Windows Media Format 11 estiverem instalados:

  • Windows XP com Service Pack 2 (SP2) e posterior.
  • Windows XP Media Center Edition 2005 com KB900325 (Windows XP Media Center Edition 2005) e KB925766 (pacote cumulativo de atualizações de outubro de 2006 para Windows XP Media Center Edition) instalados.

Requisitos

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

Confira também

Buffers de mídia

Funções do Media Foundation