IMFTopologyNode::ConnectOutput-Methode (mfidl.h)

  • Artikel

Verbindet einen Ausgabedatenstrom von diesem Knoten mit dem Eingabedatenstrom eines anderen Knotens.

Syntax

HRESULT ConnectOutput(
  [in] DWORD           dwOutputIndex,
  [in] IMFTopologyNode *pDownstreamNode,
  [in] DWORD           dwInputIndexOnDownstreamNode
);

Parameter

[in] dwOutputIndex

Nullbasierter Index des Ausgabestreams auf diesem Knoten.

[in] pDownstreamNode

Zeiger auf die IMFTopologyNode-Schnittstelle des Knotens, mit dem eine Verbindung hergestellt werden soll.

[in] dwInputIndexOnDownstreamNode

Nullbasierter Index des Eingabedatenstroms auf dem anderen Knoten.

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
 Fehler bei der Methode.
E_INVALIDARG
 Ungültiger Parameter.

Hinweise

Knotenverbindungen stellen den Datenfluss von einem Knoten zum nächsten dar. Die Streams sind logisch und werden durch index angegeben.

Wenn der Knoten bereits an der angegebenen Ausgabe verbunden ist, unterbricht die -Methode die vorhandene Verbindung. Wenn dwOutputIndex oder dwInputIndexOnDownstreamNode Datenströme angeben, die noch nicht vorhanden sind, fügt die Methode so viele Daten wie erforderlich hinzu.

Diese Methode überprüft, ob bestimmte ungültige Bedingungen erfüllt sind:

  • Ein Ausgabeknoten darf keine Ausgabeverbindungen aufweisen. Wenn Sie diese Methode auf einem Ausgabeknoten aufrufen, gibt die Methode E_FAIL zurück.
  • Ein Knoten kann nicht mit sich selbst verbunden werden. Wenn pDownstreamNode denselben Knoten wie der Methodenaufruf angibt, gibt die Methode E_INVALIDARG zurück.
Wenn die Methode erfolgreich ist, wird jedoch nicht garantiert, dass die Knotenverbindung gültig ist. Es ist möglich, eine partielle Topologie zu erstellen, die vom Topologieladeprogramm nicht aufgelöst werden kann. Wenn dies der Fall ist, schlägt die IMFTopoLoader::Load-Methode fehl.

Um eine vorhandene Knotenverbindung zu unterbrechen, rufen Sie IMFTopologyNode::D isconnectOutput auf.

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