Metodo IGraphBuilder::Connect (strmif.h)

Articolo
03/02/2024

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il Connect metodo connette i due pin usando intermedi, se necessario.

Sintassi

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

Parametri

[in] ppinOut

Puntatore all'interfaccia IPin nel pin di output.

[in] ppinIn

Puntatore all'interfaccia IPin sul pin di input.

Valore restituito

Restituisce un VALORE HRESULT. Di seguito sono indicati alcuni valori possibili.

Codice restituito	Descrizione
S_OK	Operazione completata.
VFW_S_PARTIAL_RENDER	Esito parziale; alcuni dei flussi di questo pin usano un formato non supportato.
E_ABORT	Operazione interrotta.
E_POINTER	Argomento puntatore NULL.
VFW_E_CANNOT_CONNECT	Non è possibile trovare alcuna combinazione di filtri intermedi per rendere la connessione.
VFW_E_NOT_IN_GRAPH	Almeno uno dei filtri non è nel grafico del filtro.

Commenti

Questo metodo connette due pin direttamente o indirettamente, aggiungendo filtri intermedi, se necessario. Il metodo inizia provando una connessione diretta. In caso contrario, prova a usare eventuali filtri già presenti nel grafico del filtro e hanno pin di input non connessi. Enumera questi elementi in un ordine arbitrario. In caso contrario, cerca i filtri nel Registro di sistema e li prova in ordine di merito. Per altre informazioni, vedere Intelligent Connect.

Durante il processo di connessione, Filter Graph Manager ignora i pin sui filtri intermedi se il nome del pin inizia con una tilde (~). Per altre informazioni, vedere PIN_INFO.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	strmif.h (include Dshow.h)
Libreria	Strmiids.lib

Vedi anche

Codici errore e esito positivo

Interfaccia IGraphBuilder

Condividi tramite