MFCreateMemoryBuffer-Funktion (mfapi.h)

  • Artikel

Ordnet Systemspeicher zu und erstellt einen Medienpuffer, um ihn zu verwalten.

Syntax

HRESULT MFCreateMemoryBuffer(
  DWORD          cbMaxLength,
  IMFMediaBuffer **ppBuffer
);

Parameter

cbMaxLength

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

Rückgabecode BESCHREIBUNG
S_OK
 Die Funktion wurde erfolgreich ausgeführt.
E_OUTOFMEMORY
 Nicht genügend Arbeitsspeicher.

Hinweise

Die Funktion ordnet einen Puffer mit einer 1-Byte-Speicherausrichtung zu. Um einen Puffer zuzuweisen, der an einer größeren Speichergrenze ausgerichtet ist, rufen Sie MFCreateAlignedMemoryBuffer auf.

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

Diese Funktion ist auf den folgenden Plattformen verfügbar, wenn die verteilbaren Komponenten des Windows Media Format 11 SDK installiert sind:

  • Windows XP mit Service Pack 2 (SP2) und höher.
  • Windows XP Media Center Edition 2005 mit KB900325 (Windows XP Media Center Edition 2005) und KB925766 (Updaterollup für Windows XP Media Center Edition) vom Oktober 2006) installiert.

Anforderungen

   
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

Medienpuffer

Media Foundation-Funktionen