Função MFCreateMediaBufferWrapper (mfapi.h)

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.

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

Confira também

Buffers de mídia

Funções do Media Foundation