IMFSample::ConvertToContiguousBuffer-Methode (mfobjects.h)

  • Artikel

Konvertiert ein Beispiel mit mehreren Puffern in ein Beispiel mit einem einzelnen Puffer.

Syntax

HRESULT ConvertToContiguousBuffer(
  [out] IMFMediaBuffer **ppBuffer
);

Parameter

[out] ppBuffer

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

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich ausgeführt.
E_UNEXPECTED
 Das Beispiel enthält keine Puffer.

Hinweise

Wenn das Beispiel mehr als einen Puffer enthält, kopiert diese Methode die Daten aus den ursprünglichen Puffern in einen neuen Puffer und ersetzt die ursprüngliche Pufferliste durch den neuen Puffer. Der neue Puffer wird im ppBuffer-Parameter zurückgegeben.

Wenn das Beispiel einen einzelnen Puffer enthält, gibt diese Methode einen Zeiger auf den ursprünglichen Puffer zurück. Bei typischer Verwendung enthalten die meisten Beispiele nicht mehrere Puffer.

Diese Schnittstelle 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 mfobjects.h (include Mfidl.h)
Bibliothek Mfuuid.lib

Weitere Informationen

IMFSample

Medienbeispiele