MFCreateAlignedMemoryBuffer-Funktion (mfapi.h)

  • Artikel

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
);

Parameter

cbMaxLength

Größe des Puffers in Bytes.

cbAligment

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

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

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ögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode Beschreibung
S_OK
 Die Funktion wurde erfolgreich ausgeführt.

Hinweise

Wenn das Medienpufferobjekt zerstört wird, gibt es den zugewiesenen Arbeitsspeicher frei.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfapi.h
Bibliothek Mfplat.lib
DLL Mfplat.dll

Weitere Informationen

MFCreateMemoryBuffer

Medienpuffer

Media Foundation-Funktionen