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。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼	Description
S_OK	此函數已成功。

備註

當媒體緩衝區對象終結時，它會釋放配置的記憶體。

規格需求

需求	值
最低支援的用戶端	Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	mfapi.h
程式庫	Mfplat.lib
Dll	Mfplat.dll

另請參閱

MFCreateMemoryBuffer

媒體緩衝區

媒體基礎函式