IMFDeviceTransform::GetInputStreamPreferredState-Methode (mftransform.h)
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 |
|---|---|
|
Der Übergang des Streamzustands war erfolgreich. |
|
Geräte-MFT konnte die Anforderung zu diesem Zeitpunkt nicht unterstützen. |
|
Eine ungültige Stream-ID wurde übergeben. |
|
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 |