IMFDeviceTransform::P rocessInput-Methode (mftransform.h)

Artikel
02/29/2024

Die ProcessInput-Methode übermittelt Daten an einen Eingabedatenstrom für diese Media Foundation-Transformation (MFT).

Syntax

HRESULT ProcessInput(
  [in] DWORD     dwInputStreamID,
  [in] IMFSample *pSample,
  [in] DWORD     dwFlags
);

Parameter

[in] dwInputStreamID

Eingabedatenstrombezeichner.

[in] pSample

Zeiger auf die IMFSample-Schnittstelle des Eingabebeispiels. Das Beispiel muss mindestens einen Medienpuffer enthalten, der gültige Eingabedaten enthält.

[in] dwFlags

Muss Null sein.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem Werte, die in der folgenden Tabelle angegeben sind.

Rückgabecode	BESCHREIBUNG
S_OK	Methode war erfolgreich.
E_INVALIDARG	Ungültiges Argument übergeben.
MF_E_INVALIDREQUEST	Geräte-MFT konnte die Anforderung zu diesem Zeitpunkt nicht unterstützen.
MF_E_INVAILIDSTREAMNUMBER	Eine ungültige Stream-ID wurde übergeben.
MF_E_INVALID_STREAM_STATE	Der angeforderte Streamübergang ist nicht möglich.
MF_E_TRANSFORM_TYPE_NOT_SET	Der Eingabemedientyp wurde nicht festgelegt.

Hinweise

Wenn die Methode erfolgreich ist, speichert die MFT in den meisten Fällen das Beispiel und enthält eine Verweisanzahl für den IMFSample-Zeiger . Wenn der MFT mit dem Beispiel fertig ist, muss es freigegeben werden, um einen Speicherverlust zu vermeiden.

Nachdem die DTM gültige Medientypen für alle Streams festgelegt hat, sollte der MFT immer in der Lage sein, mehr Eingaben zu akzeptieren und mehr Ausgaben zu erzeugen.

Wenn bei einem MFT ein nicht schwerwiegender Fehler in den Eingabedaten auftritt, kann er die Daten einfach löschen und versuchen, eine Wiederherstellung zu versuchen, wenn die mehr Eingabedaten abgerufen werden. Wenn der MFT Daten löscht, sollte das attribut MFSampleExtension_Discontinuity für das nächste Ausgabebeispiel festgelegt werden, um den Aufrufer darüber zu benachrichtigen, dass eine Lücke im Datenstrom vorhanden ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1703
Zielplattform	Windows
Kopfzeile	mftransform.h

Weitere Informationen

IMFDeviceTransform

Freigeben über