Método IGraphBuilder::Connect (strmif.h)

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O Connect método conecta os dois pinos, usando intermediários, se necessário.

Sintaxe

HRESULT Connect(
  [in] IPin *ppinOut,
  [in] IPin *ppinIn
);

Parâmetros

[in] ppinOut

Ponteiro para a interface IPin no pino de saída.

[in] ppinIn

Ponteiro para a interface IPin no pino de entrada.

Retornar valor

Retorna um HRESULT. Os possíveis valores incluem os seguintes.

Código de retorno Descrição
S_OK
 Êxito.
VFW_S_PARTIAL_RENDER
 Êxito parcial; alguns dos fluxos desse pino usam um formato sem suporte.
E_ABORT
 Operação anulada.
E_POINTER
 Argumento de ponteiro NULL.
VFW_E_CANNOT_CONNECT
 Não foi possível encontrar nenhuma combinação de filtros intermediários para fazer a conexão.
VFW_E_NOT_IN_GRAPH
 Pelo menos um dos filtros não está no grafo de filtro.

Comentários

Esse método conecta dois pinos direta ou indiretamente, adicionando filtros intermediários, se necessário. O método começa tentando uma conexão direta. Se isso falhar, ele tentará usar todos os filtros que já estão no grafo de filtro e têm pinos de entrada não conectados. (Ele os enumera em uma ordem arbitrária.) Se isso falhar, ele procurará filtros no registro e os tentará por mérito. Para obter mais informações, consulte Conexão inteligente.

Durante o processo de conexão, o Gerenciador do Gráfico de Filtro ignorará os pinos em filtros intermediários se o nome do pino começar com um til (~). Para obter mais informações, consulte PIN_INFO.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho strmif.h (inclua Dshow.h)
Biblioteca Strmiids.lib

Confira também

Códigos de erro e êxito

IGraphBuilder Interface