MFCreateLegacyMediaBufferOnMFMediaBuffer-Funktion (mfapi.h)
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 |
|---|---|
|
Die Funktion wurde erfolgreich ausgeführt. |
|
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 |