Função MFCreateDXSurfaceBuffer (mfapi.h)

  • Artigo

Cria um objeto de buffer de mídia que gerencia uma superfície do Direct3D 9.

Sintaxe

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

Parâmetros

[in] riid

Identifica o tipo de superfície do Direct3D 9. Atualmente, esse valor deve ser IID_IDirect3DSurface9.

[in] punkSurface

Um ponteiro para a interface IUnknown da superfície DirectX.

[in] fBottomUpWhenLinear

Se TRUE, o método IMF2DBuffer::ContiguousCopyTo do buffer copiará o buffer em um formato de baixo para cima. O formato de baixo para cima é compatível com GDI para imagens RGB descompactadas. Se esse parâmetro for FALSE, o método ContiguousCopyTo copiará o buffer em um formato de cima para baixo, que é compatível com DirectX.

Para obter mais informações sobre imagens de cima para baixo versus de baixo para cima, consulte Image Stride.

[out] ppBuffer

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

Retornar valor

A função 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 inválido.

Comentários

Essa função cria um objeto de buffer de mídia que contém um ponteiro para a superfície Direct3D especificada em punkSurface. Bloquear o buffer dá ao chamador acesso à memória da superfície. Quando o objeto buffer é destruído, ele libera a superfície. Para obter mais informações sobre buffers de mídia, consulte Buffers de mídia.

Nota Essa função não aloca a superfície direct3D em si.
 
O objeto buffer criado por essa função também expõe a interface IMF2DBuffer . Para obter mais informações, consulte DirectX Surface Buffer.

Essa função não dá suporte a superfícies DXGI.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mfapi.h
Biblioteca Evr.lib
DLL Evr.dll

Confira também

Buffer de Superfície do DirectX

Buffers de mídia

Funções do Media Foundation