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.
| Código de retorno | Descrição |
|---|---|
|
Êxito. |
|
Êxito parcial; alguns dos fluxos desse pino usam um formato sem suporte. |
|
Operação anulada. |
|
Argumento de ponteiro NULL. |
|
Não foi possível encontrar nenhuma combinação de filtros intermediários para fazer a conexão. |
|
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 |