IMFDeviceTransform::SetInputStreamState-Methode (mftransform.h)

Artikel
08/24/2023

Die SetInputStreamState-Methode legt den Geräte-MFT-Eingabestreamstatus und den Medientyp fest.

Syntax

HRESULT SetInputStreamState(
  [in] DWORD             dwStreamID,
  [in] IMFMediaType      *pMediaType,
  [in] DeviceStreamState value,
  [in] DWORD             dwFlags
);

Parameter

[in] dwStreamID

Stream-ID des Eingabedatenstroms, in dem der Zustand und der Medientyp geändert werden müssen.

[in] pMediaType

Der bevorzugte Medientyp für den Eingabedatenstrom wird über diesen Parameter übergeben. Geräte-MFT sollte den Medientyp nur ändern, wenn sich der eingehende Medientyp vom aktuellen Medientyp unterscheidet.

[in] value

Gibt den DeviceStreamState an, in den der Eingabedatenstrom übergehen soll.

[in] dwFlags

Wenn S_OK zurückgegeben wird, führen Sie den Zustandsänderungsvorgang aus. Andernfalls enthält dies einen Fehler, der beim Festlegen des Medientyps auf dem devproxy-Ausgabepin aufgetreten ist. Geben Sie den Fehler in diesem Fall entsprechend weiter.

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	Initialisierung erfolgreich
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.

Hinweise

Diese Schnittstellenfunktion hilft beim Übergang des Eingabedatenstroms in einen angegebenen Zustand mit einem angegebenen Medientyp, der für den Eingabedatenstrom festgelegt ist. Dies wird vom Gerätetransformations-Manager (DTM) verwendet, wenn der Geräte-MFT die Änderung des Zustands und Medientyps eines bestimmten Eingabedatenstroms anfordert. Geräte-MFT muss eine solche Änderung anfordern, wenn sich eine ausgabe des Geräte-MFT ändert.

Betrachten Sie als Beispiel ein Device MFT, das über zwei Eingabe- und drei Ausgabestreams verfügt. Lassen Sie Ausgabe 1 und Ausgabe 2 quelle von Input 1 und Stream bei 720p. Wenn sich der Medientyp von Ausgabe 2 nun in 1080p ändert, muss Device MFT den Medientyp von Input 1 in 1080p ändern. Um dies zu erreichen, sollte Device MFT DTM auffordern, diese Methode mithilfe der METransformInputStreamStateChanged-Nachricht aufzurufen.

Anforderungen


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

Weitere Informationen

IMFDeviceTransform

Freigeben über