MFCreateAlignedMemoryBuffer 函数 (mfapi.h)

  • 项目

使用指定的字节对齐方式分配系统内存，并创建媒体缓冲区来管理内存。

语法

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

参数

cbMaxLength

缓冲区的大小（以字节为单位）。

cbAligment

指定缓冲区的内存对齐方式。 使用以下常量之一。

值 含义
MF_1_BYTE_ALIGNMENT
0x00000000
 对齐到 1 个字节。
MF_2_BYTE_ALIGNMENT
0x00000001
 对齐到 2 个字节。
MF_4_BYTE_ALIGNMENT
0x00000003
 对齐到 4 个字节。
MF_8_BYTE_ALIGNMENT
0x00000007
 对齐到 8 个字节。
MF_16_BYTE_ALIGNMENT
0x0000000F
 对齐到 16 个字节。
MF_32_BYTE_ALIGNMENT
0x0000001F
 对齐到 32 个字节。
MF_64_BYTE_ALIGNMENT
0x0000003F
 对齐到 64 个字节。
MF_128_BYTE_ALIGNMENT
0x0000007F
 对齐到 128 字节。
MF_256_BYTE_ALIGNMENT
0x000000FF
 对齐到 256 字节。
MF_512_BYTE_ALIGNMENT
0x000001FF
 对齐到 512 字节。

ppBuffer

接收指向媒体缓冲区的 IMFMediaBuffer 接口的指针。 调用方必须释放接口。

返回值

函数返回 HRESULT。 可能的值包括（但并不限于）下表中的项。

返回代码 说明
S_OK
 函数成功。

注解

当媒体缓冲区对象被销毁时，它会释放分配的内存。

要求

要求 值
最低受支持的客户端 Windows Vista [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2008 [桌面应用 | UWP 应用]
目标平台 Windows
标头 mfapi.h
Library Mfplat.lib
DLL Mfplat.dll

另请参阅

MFCreateMemoryBuffer

媒体缓冲区

媒体基础函数