IMFTopologyNode::GetInputPrefType-Methode (mfidl.h)

  • Artikel

Ruft den bevorzugten Medientyp für einen Eingabedatenstrom auf diesem Knoten ab.

Syntax

HRESULT GetInputPrefType(
  [in]  DWORD        dwInputIndex,
  [out] IMFMediaType **ppType
);

Parameter

[in] dwInputIndex

Nullbasierter Index des Eingabedatenstroms.

[out] ppType

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

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.
E_FAIL
 Dieser Knoten verfügt nicht über einen bevorzugten Eingabetyp.
E_INVALIDARG
 Ungültiger Streamindex.
E_NOTIMPL
 Dieser Knoten ist ein Quellknoten.

Hinweise

Quellknoten können keine Eingaben haben. Wenn diese Methode auf einem Quellknoten aufgerufen wird, wird E_NOTIMPL zurückgegeben.

Der bevorzugte Eingabetyp stellt einen Hinweis für den Topologieladeprogramm bereit. In einer vollständig aufgelösten Topologie gibt es keine Garantie, dass jeder Topologieknoten über einen bevorzugten Eingabetyp verfügt. Um den tatsächlichen Medientyp für einen Knoten abzurufen, müssen Sie einen Zeiger auf das dem Knoten zugrunde liegende Objekt abrufen. (Weitere Informationen finden Sie unter MF_TOPOLOGY_TYPE Enumeration.)

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mfidl.h
Bibliothek Mfuuid.lib

Weitere Informationen

IMFTopologyNode

Topologien