Método IMFSample::GetBufferByIndex (mfobjects.h)
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 |
|---|---|
|
O método foi bem-sucedido. |
|
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 |