MFCreateLegacyMediaBufferOnMFMediaBuffer-Funktion (mfapi.h)

Artikel
08/24/2023

Konvertiert einen Media Foundation-Medienpuffer in einen Puffer, der mit DirectX Media Objects (DMOs) kompatibel ist.

Syntax

HRESULT MFCreateLegacyMediaBufferOnMFMediaBuffer(
  IMFSample      *pSample,
  IMFMediaBuffer *pMFMediaBuffer,
  DWORD          cbOffset,
  IMediaBuffer   **ppMediaBuffer
);

Parameter

pSample

Zeiger auf die IMFSample-Schnittstelle des Beispiels, das den Media Foundation-Puffer enthält. Dieser Parameter kann NULL sein.

pMFMediaBuffer

Zeiger auf die IMFMediaBuffer-Schnittstelle des Media Foundation-Puffers.

cbOffset

Offset in Bytes ab dem Start des Media Foundation-Puffers. Dieser Offset definiert, wo der DMO-Puffer beginnt. Wenn dieser Parameter 0 ist, beginnt der DMO-Puffer am Anfang des Media Foundation-Puffers.

ppMediaBuffer

Empfängt einen Zeiger auf die IMediaBuffer-Schnittstelle . Diese Schnittstelle ist in der DirectShow SDK-Dokumentation dokumentiert. 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	Ungültiges Argument. Der pIMFMediaBuffer-Parameter darf nicht NULL sein.

Hinweise

Der von dieser Funktion erstellte DMO-Puffer macht auch die IMFSample-Schnittstelle verfügbar. Wenn pIMFSampleNULL ist, geben alle IMFSample-Methoden MF_E_NOT_INITIALIZED zurück. Andernfalls rufen sie den pIMFSample-Zeiger auf.

Wenn der von pIMFMediaBuffer angegebene Media Foundation-Puffer die IMF2DBuffer-Schnittstelle verfügbar macht, macht der DMO-Puffer auch IMF2DBuffer verfügbar.

Anforderungen


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

Weitere Informationen

Media Foundation-Funktionen