Méthode IMFTopologyNode::ConnectOutput (mfidl.h)

  • Article

Connecte un flux de sortie de ce nœud au flux d’entrée d’un autre nœud.

Syntaxe

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

Paramètres

[in] dwOutputIndex

Index de base zéro du flux de sortie sur ce nœud.

[in] pDownstreamNode

Pointeur vers l’interface IMFTopologyNode du nœud auquel se connecter.

[in] dwInputIndexOnDownstreamNode

Index de base zéro du flux d’entrée sur l’autre nœud.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour Description
S_OK
 S_OK
E_FAIL
 Échec de la méthode.
E_INVALIDARG
 Paramètre non valide.

Notes

Les connexions de nœud représentent le flux de données d’un nœud à l’autre. Les flux sont logiques et sont spécifiés par l’index.

Si le nœud est déjà connecté à la sortie spécifiée, la méthode interrompt la connexion existante. Si dwOutputIndex ou dwInputIndexOnDownstreamNode spécifient des flux qui n’existent pas encore, la méthode ajoute autant de flux que nécessaire.

Cette méthode recherche certaines conditions non valides :

  • Un nœud de sortie ne peut pas avoir de connexions de sortie. Si vous appelez cette méthode sur un nœud de sortie, la méthode retourne E_FAIL.
  • Un nœud ne peut pas être connecté à lui-même. Si pDownstreamNode spécifie le même nœud que l’appel de méthode, la méthode retourne E_INVALIDARG.
Toutefois, si la méthode réussit, elle ne garantit pas que la connexion au nœud est valide. Il est possible de créer une topologie partielle que le chargeur de topologie ne peut pas résoudre. Dans ce cas, la méthode IMFTopoLoader::Load échoue.

Pour rompre une connexion de nœud existante, appelez IMFTopologyNode::D isconnectOutput.

Spécifications

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête mfidl.h
Bibliothèque Mfuuid.lib

Voir aussi

IMFTopologyNode

Topologies