MFCreateAlignedMemoryBuffer-Funktion (mfapi.h)

Weist den Systemspeicher mit einer angegebenen Byteausrichtung zu und erstellt einen Medienpuffer zum Verwalten des Arbeitsspeichers.

Syntax

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

Die Parameter

cbMaxLength

Größe des Puffers in Byte.

cbAligment

Gibt die Speicherausrichtung für den Puffer an. Verwenden Sie eine der folgenden Konstanten.

Wert	Bedeutung
MF_1_BYTE_ALIGNMENT 0x00000000	Ausrichten an 1 Byte.
MF_2_BYTE_ALIGNMENT 0x00000001	2 Byte ausrichten.
MF_4_BYTE_ALIGNMENT 0x00000003	Ausrichten an 4 Byte.
MF_8_BYTE_ALIGNMENT 0x00000007	Ausrichten an 8 Bytes.
MF_16_BYTE_ALIGNMENT 0x0000000F	Ausrichten an 16 Byte.
MF_32_BYTE_ALIGNMENT 0x0000001F	Ausrichten an 32 Bytes.
MF_64_BYTE_ALIGNMENT 0x0000003F	Ausrichten an 64 Bytes.
MF_128_BYTE_ALIGNMENT 0x0000007F	Ausrichten an 128 Bytes.
MF_256_BYTE_ALIGNMENT 0x000000FF	Ausrichten an 256 Bytes.
MF_512_BYTE_ALIGNMENT 0x000001FF	Ausrichten an 512 Bytes.

ppBuffer

Empfängt einen Zeiger auf die IMFMediaBuffer-Schnittstelle des Medienpuffers. Der Aufrufer muss die Schnittstelle freigeben.

Rückgabewert

Die Funktion gibt ein HRESULT zurück. Mögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt.

Rückgabecode	Description
S_OK	Die Funktion war erfolgreich.

Bemerkungen

Wenn das Medienpufferobjekt zerstört wird, wird der zugeordnete Speicher freigegeben.

Anforderungen

Anforderung	Wert
Mindestens unterstützter Client	Windows Vista [Desktop-Apps | UWP-Apps]
Mindestanforderungen für unterstützte Server	Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform	Fenster
Header	mfapi.h
Library	Mfplat.lib
DLL	Mfplat.dll

Siehe auch

MFCreateMemoryBuffer

Medienpuffer

Media Foundation-Funktionen