Freigeben über

IMFDeviceTransform::SetInputStreamState-Methode (mftransform.h)

  • Artikel

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