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

  • Artigo

Conecta um fluxo de saída desse nó ao fluxo de entrada de outro nó.

Sintaxe

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

Parâmetros

[in] dwOutputIndex

Índice baseado em zero do fluxo de saída neste nó.

[in] pDownstreamNode

Ponteiro para a interface IMFTopologyNode do nó ao qual se conectar.

[in] dwInputIndexOnDownstreamNode

Índice baseado em zero do fluxo de entrada no outro nó.

Valor retornado

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
E_FAIL
 O método falhou.
E_INVALIDARG
 Parâmetro inválido.

Comentários

As conexões de nó representam o fluxo de dados de um nó para o próximo. Os fluxos são lógicos e são especificados pelo índice.

Se o nó já estiver conectado na saída especificada, o método interromperá a conexão existente. Se dwOutputIndex ou dwInputIndexOnDownstreamNode especificar fluxos que ainda não existem, o método adicionará quantos fluxos forem necessários.

Esse método verifica se há determinadas condições inválidas:

  • Um nó de saída não pode ter nenhuma conexão de saída. Se você chamar esse método em um nó de saída, o método retornará E_FAIL.
  • Um nó não pode ser conectado a si mesmo. Se pDownstreamNode especificar o mesmo nó que a chamada de método, o método retornará E_INVALIDARG.
No entanto, se o método for bem-sucedido, ele não garantirá que a conexão do nó seja válida. É possível criar uma topologia parcial que o carregador de topologia não pode resolve. Nesse caso, o método IMFTopoLoader::Load falhará.

Para interromper uma conexão de nó existente, chame IMFTopologyNode::D isconnectOutput.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mfidl.h
Biblioteca Mfuuid.lib

Confira também

IMFTopologyNode

Topologias