IMFTransform::GetInputStatus-Methode (mftransform.h)

Fragt ab, ob ein Eingabedatenstrom für diese Media Foundation-Transformation (MFT) mehr Daten akzeptieren kann.

Syntax

HRESULT GetInputStatus(
  [in]  DWORD dwInputStreamID,
  [out] DWORD *pdwFlags
);

Parameter

[in] dwInputStreamID

Eingabedatenstrombezeichner. Um die Liste der Streambezeichner abzurufen, rufen Sie IMFTransform::GetStreamIDs auf.

[out] pdwFlags

Empfängt einen Member der _MFT_INPUT_STATUS_FLAGS-Enumeration oder null. Wenn der Wert MFT_INPUT_STATUS_ACCEPT_DATA ist, kann der in dwInputStreamID angegebene Stream mehr Eingabedaten akzeptieren.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
Die Methode wurde erfolgreich ausgeführt.
MF_E_INVALIDSTREAMNUMBER
Ungültiger Streambezeichner.
MF_E_TRANSFORM_TYPE_NOT_SET
Der Medientyp ist nicht für einen oder mehrere Streams festgelegt.

Hinweise

Wenn die Methode das flag MFT_INPUT_STATUS_ACCEPT_DATA zurückgibt, können Sie ein Eingabebeispiel an den angegebenen Stream übermitteln, indem Sie IMFTransform::P rocessInput aufrufen. Wenn die Methode erfolgreich ist, aber keine Flags im pdwFlags-Parameter zurückgibt, bedeutet dies, dass der Eingabedatenstrom bereits über so viele Daten verfügt, wie er akzeptieren kann.

Verwenden Sie diese Methode, um zu testen, ob der Eingabedatenstrom bereit ist, weitere Daten zu akzeptieren, ohne dass der Aufwand für die Zuweisung eines neuen Beispiels und das Aufrufen von ProcessInput entsteht.

Nachdem der Client gültige Medientypen für alle Streams festgelegt hat, sollte sich der MFT immer in einem von zwei Zuständen befinden: Mehr Eingaben akzeptieren oder mehr Ausgaben (oder beides) erzeugen können.

Wenn MFT_UNIQUE_METHOD_NAMES vor dem Einschließen von mftransform.h definiert ist, wird diese Methode in MFTGetInputStatus umbenannt. Weitere Informationen finden Sie unter Erstellen von DMO/MFT-Hybridobjekten.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mftransform.h
Bibliothek Mfuuid.lib

Weitere Informationen

IMFTransform

Media Foundation-Transformationen