Função MFCreateAlignedMemoryBuffer (mfapi.h)

Aloca memória do sistema com um alinhamento de bytes especificado e cria um buffer de mídia para gerenciar a memória.

Sintaxe

HRESULT MFCreateAlignedMemoryBuffer(
  DWORD          cbMaxLength,
  DWORD          cbAligment,
  IMFMediaBuffer **ppBuffer
);

Parâmetros

cbMaxLength

Tamanho do buffer, em bytes.

cbAligment

Especifica o alinhamento de memória para o buffer. Use uma das constantes a seguir.

Valor	Significado
MF_1_BYTE_ALIGNMENT 0x00000000	Alinhar a 1 bytes.
MF_2_BYTE_ALIGNMENT 0x00000001	Alinhar a 2 bytes.
MF_4_BYTE_ALIGNMENT 0x00000003	Alinhar a 4 bytes.
MF_8_BYTE_ALIGNMENT 0x00000007	Alinhar a 8 bytes.
MF_16_BYTE_ALIGNMENT 0x0000000F	Alinhar a 16 bytes.
MF_32_BYTE_ALIGNMENT 0x0000001F	Alinhar a 32 bytes.
MF_64_BYTE_ALIGNMENT 0x0000003F	Alinhar a 64 bytes.
MF_128_BYTE_ALIGNMENT 0x0000007F	Alinhar a 128 bytes.
MF_256_BYTE_ALIGNMENT 0x000000FF	Alinhar a 256 bytes.
MF_512_BYTE_ALIGNMENT 0x000001FF	Alinhar a 512 bytes.

ppBuffer

Recebe um ponteiro para a interface IMFMediaBuffer do buffer de mídia. O chamador deve liberar a interface.

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	A função foi bem-sucedida.

Comentários

Quando o objeto de buffer de mídia é destruído, ele libera a memória alocada.

Requisitos

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

Confira também

MFCreateMemoryBuffer

Buffers de mídia

Funções do Media Foundation