Función MFCreateDXSurfaceBuffer (mfapi.h)

Crea un objeto de búfer multimedia que administra una superficie de Direct3D 9.

Sintaxis

HRESULT MFCreateDXSurfaceBuffer(
  [in]  REFIID         riid,
  [in]  IUnknown       *punkSurface,
  [in]  BOOL           fBottomUpWhenLinear,
  [out] IMFMediaBuffer **ppBuffer
);

Parámetros

[in] riid

Identifica el tipo de superficie de Direct3D 9. Actualmente, este valor debe ser IID_IDirect3DSurface9.

[in] punkSurface

Puntero a la interfaz IUnknown de la superficie de DirectX.

[in] fBottomUpWhenLinear

Si es TRUE, el método IMF2DBuffer::ContiguousCopyTo del búfer copia el búfer en un formato de abajo arriba. El formato inferior es compatible con GDI para imágenes RGB sin comprimir. Si este parámetro es FALSE, el método ContiguousCopyTo copia el búfer en un formato de arriba abajo, que es compatible con DirectX.

Para obtener más información sobre las imágenes de arriba abajo frente a las imágenes de abajo arriba, consulte Image Stride.

[out] ppBuffer

Recibe un puntero a la interfaz IMFMediaBuffer . El autor de la llamada debe liberar el búfer.

Valor devuelto

La función 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 no válido.

Comentarios

Esta función crea un objeto de búfer multimedia que contiene un puntero a la superficie de Direct3D especificada en punkSurface. Bloquear el búfer proporciona al autor de la llamada acceso a la memoria expuesta. Cuando se destruye el objeto de búfer, libera la superficie. Para obtener más información sobre los búferes multimedia, consulte Búferes multimedia.

Nota Esta función no asigna la propia superficie de Direct3D.
 
El objeto de búfer creado por esta función también expone la interfaz IMF2DBuffer . Para obtener más información, consulta DirectX Surface Buffer.

Esta función no admite superficies DXGI.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mfapi.h
Library Evr.lib
Archivo DLL Evr.dll

Consulte también

Búfer de Superficie de DirectX

Búferes multimedia

Funciones de Media Foundation