Método IMFSample::GetBufferByIndex (mfobjects.h)

  • Artigo

Obtém um buffer do exemplo, por índice.

Nota Na maioria dos casos, é mais seguro usar o método IMFSample::ConvertToContiguousBuffer . Se o exemplo contiver mais de um buffer, o método ConvertToContiguousBuffer os substituirá por um único buffer, copiará os dados originais para esse buffer e retornará o novo buffer para o chamador. A operação de cópia ocorre no máximo uma vez. Em chamadas subsequentes, nenhum dado é copiado.
 

Sintaxe

HRESULT GetBufferByIndex(
  [in]  DWORD          dwIndex,
  [out] IMFMediaBuffer **ppBuffer
);

Parâmetros

[in] dwIndex

Índice do buffer. Para localizar o número de buffers no exemplo, chame IMFSample::GetBufferCount. Os buffers são indexados a partir de zero.

[out] ppBuffer

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

Retornar valor

O método 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
 O método foi bem-sucedido.
E_INVALIDARG
 Argumento de ponteiro NULL ou o índice está fora do intervalo.

Comentários

Um exemplo pode conter mais de um buffer. Use o método GetBufferByIndex para enumerar os buffers individuais.

Essa interface 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 mfobjects.h (include Mfidl.h)
Biblioteca Mfuuid.lib

Confira também

IMFSample

IMFSample::ConvertToContiguousBuffer

Exemplos de mídia