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

  • Artículo

Conecta un flujo de salida de este nodo al flujo de entrada de otro nodo.

Sintaxis

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

Parámetros

[in] dwOutputIndex

Índice de base cero del flujo de salida en este nodo.

[in] pDownstreamNode

Puntero a la interfaz IMFTopologyNode del nodo al que se va a conectar.

[in] dwInputIndexOnDownstreamNode

Índice de base cero del flujo de entrada en el otro nodo.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
E_FAIL
 Error en el método.
E_INVALIDARG
 Parámetro no válido.

Comentarios

Las conexiones de nodo representan el flujo de datos de un nodo al siguiente. Las secuencias son lógicas y se especifican por índice.

Si el nodo ya está conectado en la salida especificada, el método interrumpe la conexión existente. Si dwOutputIndex o dwInputIndexOnDownstreamNode especifican secuencias que aún no existen, el método agrega tantas secuencias como sea necesario.

Este método comprueba si hay ciertas condiciones no válidas:

  • Un nodo de salida no puede tener ninguna conexión de salida. Si llama a este método en un nodo de salida, el método devuelve E_FAIL.
  • Un nodo no se puede conectar a sí mismo. Si pDownstreamNode especifica el mismo nodo que la llamada al método, el método devuelve E_INVALIDARG.
Sin embargo, si el método se realiza correctamente, no garantiza que la conexión del nodo sea válida. Es posible crear una topología parcial que el cargador de topologías no pueda resolver. Si es así, se producirá un error en el método IMFTopoLoader::Load .

Para interrumpir una conexión de nodo existente, llame a IMFTopologyNode::D isconnectOutput.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mfidl.h
Library Mfuuid.lib

Consulte también

IMFTopologyNode

Topologías