Compartilhar via


Função MFCreate2DMediaBuffer (mfapi.h)

Cria um objeto de buffer de memória do sistema para armazenar dados de imagem 2D.

Sintaxe

HRESULT MFCreate2DMediaBuffer(
  [in]  DWORD          dwWidth,
  [in]  DWORD          dwHeight,
  [in]  DWORD          dwFourCC,
  [in]  BOOL           fBottomUp,
  [out] IMFMediaBuffer **ppBuffer
);

Parâmetros

[in] dwWidth

Largura da imagem, em pixels.

[in] dwHeight

Altura da imagem, em pixels.

[in] dwFourCC

Um código FOURCC ou D3DFORMAT valor que especifica o formato de vídeo. Se você tiver um GUID de subtipo de vídeo, poderá usar o primeiro DWORD do subtipo.

[in] fBottomUp

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 .

Valor retornado

Essa função pode retornar um desses valores.

Código de retorno Descrição
S_OK
Êxito.
MF_E_INVALIDMEDIATYPE
Formato de vídeo não reconhecido.

Comentários

O objeto buffer retornado também expõe a interface IMF2DBuffer2 .

Requisitos

   
Cliente mínimo com suporte Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho mfapi.h
Biblioteca Mfplat.lib
DLL Mfplat.dll

Confira também

Funções do Media Foundation