Share via

MFCreateMediaBufferWrapper-Funktion (mfapi.h)

  • Artikel

Erstellt einen Medienpuffer, der einen vorhandenen Medienpuffer umschließt. Der neue Medienpuffer verweist auf denselben Arbeitsspeicher wie der ursprüngliche Medienpuffer oder auf einen Offset vom Anfang des Arbeitsspeichers.

Syntax

HRESULT MFCreateMediaBufferWrapper(
  [in]  IMFMediaBuffer *pBuffer,
  [in]  DWORD          cbOffset,
  [in]  DWORD          dwLength,
  [out] IMFMediaBuffer **ppBuffer
);

Parameter

[in] pBuffer

Ein Zeiger auf die IMFMediaBuffer-Schnittstelle des ursprünglichen Medienpuffers.

[in] cbOffset

Der Start des neuen Puffers als Offset in Bytes ab dem Anfang des ursprünglichen Puffers.

[in] dwLength

Die Größe des neuen Puffers. Der Wert von cbOffset + dwLength muss kleiner oder gleich der Größe der gültigen Daten des ursprünglichen Puffers sein. (Die Größe der gültigen Daten wird von der IMFMediaBuffer::GetCurrentLength-Methode zurückgegeben.)

[out] ppBuffer

Empfängt einen Zeiger auf die IMFMediaBuffer-Schnittstelle . 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_INVALIDARG
 Der angeforderte Offset oder die angeforderte Länge ist ungültig.

Hinweise

Die maximale Größe des Wrapperpuffers ist auf die Größe der gültigen Daten im ursprünglichen Puffer beschränkt. Dies kann kleiner sein als die zugewiesene Größe des ursprünglichen Puffers. Um die Größe der gültigen Daten festzulegen, rufen Sie IMFMediaBuffer::SetCurrentLength auf.

Diese Funktion ist auf den folgenden Plattformen verfügbar, wenn die verteilbaren Windows Media Format 11 SDK-Komponenten 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

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

Medienpuffer

Media Foundation-Funktionen