Compartilhar via


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