MFGetTopoNodeCurrentType-Funktion (mfidl.h)

  • Artikel

Ruft den Medientyp für einen Stream ab, der einem Topologieknoten zugeordnet ist.

Syntax

HRESULT MFGetTopoNodeCurrentType(
        IMFTopologyNode *pNode,
        DWORD           dwStreamIndex,
        BOOL            fOutput,
  [out] IMFMediaType    **ppType
);

Parameter

pNode

Ein Zeiger auf die IMFTopologyNode-Schnittstelle .

dwStreamIndex

Der Bezeichner des abzufragenden Datenstroms. Dieser Parameter wird wie folgt interpretiert:

  • Transformationsknoten: Der Wert ist der nullbasierte Index des Eingabe- oder Ausgabestreams.
  • Alle anderen Knotentypen: Der Wert muss 0 sein.

fOutput

Bei TRUE erhält die Funktion einen Ausgabetyp. Bei FALSE erhält die Funktion einen Eingabetyp. Dieser Parameter wird wie folgt interpretiert:

  • Ausgabeknoten: Der Wert muss TRUE sein.
  • Quellknoten: Der Wert muss FALSE sein.
  • Teeknoten: Der Wert wird ignoriert.
  • Transformationsknoten: Wenn der Wert TRUE ist, ist der dwStreamIndex-Parameter der Index für einen Ausgabestream. Andernfalls ist dwStreamIndex der Index für einen Eingabedatenstrom.

[out] ppType

Empfängt einen Zeiger auf die IMFMediaType-Schnittstelle . Der Aufrufer muss die Schnittstelle freigeben.

Rückgabewert

Die Funktion 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
 Der Streamindex ist ungültig.

Hinweise

Diese Funktion ruft den tatsächlichen Medientyp aus dem Objekt ab, das dem Topologieknoten zugeordnet ist. Der pNode-Parameter sollte einen Knoten angeben, der zu einer vollständig aufgelösten Topologie gehört. Wenn der Knoten zu einer partiellen Topologie gehört, schlägt die Funktion wahrscheinlich fehl.

Tee-Knoten verfügen nicht über ein zu abfragende Objekt. Bei Teeknoten ruft die Funktion den Eingabetyp des Knotens ab, sofern verfügbar. Andernfalls ruft die Funktion den Medientyp des primären Ausgabedatenstroms des Knotens ab, wenn kein Eingabetyp verfügbar ist. Der primäre Ausgabestream wird durch das Attribut MF_TOPONODE_PRIMARYOUTPUT identifiziert.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mfidl.h
Bibliothek Mf.lib
DLL Mf.dll

Weitere Informationen

Media Foundation-Funktionen