Freigeben über


MFCreateAlignedMemoryBuffer Function

Allocates system memory with a specified byte alignment and creates a media buffer to manage the memory.

Syntax

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

Parameter

  • cbMaxLength
    Size of the buffer, in bytes.

  • fAlignmentFlags
    Specifies the memory alignment for the buffer. Use one of the following constants.

    Wert Bedeutung
    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
    Receives a pointer to the IMFMediaBuffer interface of the media buffer. The caller must release the interface.

Rückgabewert

The function returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Rückgabecode Beschreibung
S_OK

The function succeeded.

 

Hinweise

When the media buffer object is destroyed, it releases the allocated memory.

Anforderungen

Mindestens unterstützter Client

Windows Vista

Mindestens unterstützter Server

Windows Server 2008

Header

Mfapi.h

Bibliothek

Mfplat.lib

DLL

Mfplat.dll

Siehe auch

Media Foundation Functions

MFCreateMemoryBuffer

Media Buffers