Allocates system memory with a specified byte alignment and creates a media buffer to manage the memory.
HRESULT MFCreateAlignedMemoryBuffer(
DWORD cbMaxLength,
DWORD cbAligment,
IMFMediaBuffer **ppBuffer
)
cbMaxLength
Type: DWORD
[in]
Size of the buffer, in bytes.
cbAligment
Type: DWORD
[in] Specifies the memory alignment for the buffer. Use one of the following constants.
| Value | Meaning |
|---|---|
| MF_1_BYTE_ALIGNMENT 0x00000000 |
Align to 1 bytes. |
| MF_2_BYTE_ALIGNMENT 0x00000001 |
Align to 2 bytes. |
| MF_4_BYTE_ALIGNMENT 0x00000003 |
Align to 4 bytes. |
| MF_8_BYTE_ALIGNMENT 0x00000007 |
Align to 8 bytes. |
| MF_16_BYTE_ALIGNMENT 0x0000000F |
Align to 16 bytes. |
| MF_32_BYTE_ALIGNMENT 0x0000001F |
Align to 32 bytes. |
| MF_64_BYTE_ALIGNMENT 0x0000003F |
Align to 64 bytes. |
| MF_128_BYTE_ALIGNMENT 0x0000007F |
Align to 128 bytes. |
| MF_256_BYTE_ALIGNMENT 0x000000FF |
Align to 256 bytes. |
| MF_512_BYTE_ALIGNMENT 0x000001FF |
Align to 512 bytes. |
ppBuffer
Type: IMFMediaBuffer **
[out] Receives a pointer to the IMFMediaBuffer interface of the media buffer. The caller must release the interface.
Type: HRESULT
The function returns an HRESULT. Possible values include, but are not limited to, those in the following table.
| Return code | Description |
|---|---|
| S_OK | The function succeeded. |
Refer to Media Foundation return codes.
When the media buffer object is destroyed, it releases the allocated memory.
Header: Declared in mfapi.h.
Library: Use Mfplat.lib.