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

[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.

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

Confira também

Códigos de erro e êxito

IGraphBuilder Interface