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

  • Artículo

Obtiene un búfer del ejemplo, por índice.

Nota En la mayoría de los casos, es más seguro usar el método IMFSample::ConvertToContiguousBuffer . Si el ejemplo contiene más de un búfer, el método ConvertToContiguousBuffer los reemplaza por un único búfer, copia los datos originales en ese búfer y devuelve el nuevo búfer al autor de la llamada. La operación de copia se produce como máximo una vez. En las llamadas posteriores, no se copia ningún dato.
 

Sintaxis

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

Parámetros

[in] dwIndex

Índice del búfer. Para buscar el número de búferes en el ejemplo, llame a IMFSample::GetBufferCount. Los búferes se indexan desde cero.

[out] ppBuffer

Recibe un puntero a la interfaz IMFMediaBuffer . El autor de la llamada debe liberar la interfaz .

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
E_INVALIDARG
 Argumento de puntero NULL o el índice está fuera del intervalo.

Comentarios

Un ejemplo puede contener más de un búfer. Use el método GetBufferByIndex para enumerar los búferes individuales.

Esta interfaz está disponible en las siguientes plataformas si se instalan los componentes redistribuibles del SDK de Windows Media Format 11:

  • Windows XP con Service Pack 2 (SP2) y versiones posteriores.
  • Windows XP Media Center Edition 2005 con KB900325 (Windows XP Media Center Edition 2005) y KB925766 (paquete acumulativo de actualizaciones de octubre de 2006 para Windows XP Media Center Edition) instalado.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado mfobjects.h (include Mfidl.h)
Library Mfuuid.lib

Consulte también

IMFSample

IMFSample::ConvertToContiguousBuffer

Ejemplos de medios