Share via

Função MFCreateMediaBufferWrapper (mfapi.h)

  • Artigo

Cria um buffer de mídia que encapsula um buffer de mídia existente. O novo buffer de mídia aponta para a mesma memória que o buffer de mídia original ou para um deslocamento do início da memória.

Sintaxe

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

Parâmetros

[in] pBuffer

Um ponteiro para a interface IMFMediaBuffer do buffer de mídia original.

[in] cbOffset

O início do novo buffer, como um deslocamento em bytes do início do buffer original.

[in] dwLength

O tamanho do novo buffer. O valor de cbOffset + dwLength deve ser menor ou igual ao tamanho dos dados válidos do buffer original. (O tamanho dos dados válidos é retornado pelo método IMFMediaBuffer::GetCurrentLength .)

[out] ppBuffer

Recebe um ponteiro para a interface IMFMediaBuffer . O chamador deve liberar a interface .

Retornar valor

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
 O deslocamento solicitado ou o comprimento solicitado não é válido.

Comentários

O tamanho máximo do buffer wrapper é limitado ao tamanho dos dados válidos no buffer original. Isso pode ser menor que o tamanho alocado do buffer original. Para definir o tamanho dos dados válidos, chame IMFMediaBuffer::SetCurrentLength.

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

Requisito Valor
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