Freigeben über

IMFDeviceTransform::GetInputStreamPreferredState-Methode (mftransform.h)

  • Artikel

Die GetInputStreamPreferredState-Methode ruft den bevorzugten Zustand und Medientyp eines Device MFT-Eingabedatenstroms ab.

Syntax

HRESULT GetInputStreamPreferredState(
  [in]  DWORD             dwStreamID,
  [out] DeviceStreamState *value,
  [out] IMFMediaType      **ppMediaType
);

Parameter

[in] dwStreamID

Stream-ID des Eingabedatenstroms, dessen Zustand abgerufen werden muss.

[out] value

Gibt den aktuellen DeviceStreamState des angegebenen Geräte-MFT-Datenstroms an.

[out] ppMediaType

Der bevorzugte Medientyp für den Eingabedatenstrom wird über diesen Parameter übergeben.

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
 Der Übergang des Streamzustands war 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 Abfragen des bevorzugten Zustands und Medientyps des Geräte-MFT-Eingabedatenstroms, in den er übertragen werden muss.

Wenn eine Änderung des Medientyps des Ausgabestreams eine entsprechende Änderung in der Eingabe erfordert, postet Device MFT METransformInputStreamStateChanged in DTM, um den relevanten Eingabedatenstrom zu ändern. DTM ruft GetInputStreamPreferredState auf, um den bevorzugten Medientyp und Zustand des Geräte-MFT-Eingabestreams abzurufen.

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. Angenommen, der Medientyp von Ausgabe 2 ändert sich in 1080p. Um diese Anforderung zu erfüllen, muss Device MFT den Medientyp Input 1 in 1080p ändern, indem das METransformInputStreamStateChanged-Ereignis an die DTM gesendet wird. DTM ruft GetInputStreamPreferredState auf und ruft den bevorzugten Zustand und Medientyp ab. DTM ruft SetInputStreamState auf, um den Medientyp und Zustand des Eingabedatenstroms zu ändern.

Anforderungen

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

Weitere Informationen

IMFDeviceTransform