IMFTopologyNode::GetOutputPrefType-Methode (mfidl.h)

  • Artikel

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

Syntax

HRESULT GetOutputPrefType(
  [in]  DWORD        dwOutputIndex,
  [out] IMFMediaType **ppType
);

Parameter

[in] dwOutputIndex

Nullbasierter Index des Ausgabestreams.

[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 Ausgabetyp.
E_INVALIDARG
 Ungültiger Streamindex.
E_NOTIMPL
 Dieser Knoten ist ein Ausgabeknoten.

Hinweise

Ausgabeknoten dürfen keine Ausgaben haben. Wenn diese Methode auf einem Ausgabeknoten aufgerufen wird, gibt sie E_NOTIMPL zurück.

Der bevorzugte Ausgabetyp bietet einen Hinweis auf den Topologieladeprogramm. In einer vollständig aufgelösten Topologie gibt es keine Garantie, dass jeder Topologieknoten über einen bevorzugten Ausgabetyp 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