MFCreateMediaBufferWrapper-Funktion (mfapi.h)

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.

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

Weitere Informationen

Medienpuffer

Media Foundation-Funktionen