Función MFCreateMediaBufferWrapper (mfapi.h)

  • Artículo

Crea un búfer multimedia que encapsula un búfer multimedia existente. El nuevo búfer multimedia apunta a la misma memoria que el búfer multimedia original o a un desplazamiento desde el inicio de la memoria.

Sintaxis

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

Parámetros

[in] pBuffer

Puntero a la interfaz IMFMediaBuffer del búfer multimedia original.

[in] cbOffset

Inicio del nuevo búfer, como desplazamiento en bytes desde el inicio del búfer original.

[in] dwLength

Tamaño del nuevo búfer. El valor de cbOffset + dwLength debe ser menor o igual que el tamaño de los datos válidos del búfer original. (El tamaño de los datos válidos lo devuelve el método IMFMediaBuffer::GetCurrentLength ).

[out] ppBuffer

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

Valor devuelto

La función devuelve un HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 La función se ha realizado correctamente.
E_INVALIDARG
 El desplazamiento solicitado o la longitud solicitada no es válida.

Comentarios

El tamaño máximo del búfer contenedor se limita al tamaño de los datos válidos en el búfer original. Puede ser menor que el tamaño asignado del búfer original. Para establecer el tamaño de los datos válidos, llame a IMFMediaBuffer::SetCurrentLength.

Esta función 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 mfapi.h
Library Mfplat.lib
Archivo DLL Mfplat.dll

Consulte también

Búferes multimedia

Funciones de Media Foundation