Metodo IPin::Connect (strmif.h)

  • Articolo

[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 il pin a un altro pin.

Le applicazioni non devono chiamare questo metodo. Usare invece i metodi IGraphBuilder . Questo metodo viene chiamato da Filter Graph Manager per connettere i pin.

Sintassi

HRESULT Connect(
  [in] IPin                *pReceivePin,
  [in] const AM_MEDIA_TYPE *pmt
);

Parametri

[in] pReceivePin

Puntatore all'interfaccia IPin del pin di ricezione.

[in] pmt

Puntatore a una struttura AM_MEDIA_TYPE che specifica il tipo di supporto per la connessione. Può essere NULL.

Valore restituito

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

Codice restituito Descrizione
S_OK
 Operazione completata.
VFW_E_ALREADY_CONNECTED
 Il pin è già connesso.
VFW_E_NO_ACCEPTABLE_TYPES
 Impossibile trovare un tipo di supporto accettabile.
VFW_E_NO_TRANSPORT
 I pin non possono accettare un trasporto o non esiste alcun allocatore per la connessione.
VFW_E_NOT_STOPPED
 Il filtro è attivo e il pin non supporta la riconnessione dinamica.
VFW_E_TYPE_NOT_ACCEPTED
 Il tipo di supporto specificato non è accettabile.

Commenti

Il parametro pmt può essere NULL. Può anche specificare un tipo di supporto parziale, con un valore di GUID_NULL per il tipo principale, il sottotipo o il formato.

Questo metodo verifica che la connessione sia possibile. Se il pin rifiuta la connessione, il metodo ha esito negativo. Il pin di connessione propone tipi di supporti chiamando IPin::ReceiveConnection nel pin di ricezione.

Requisiti

   
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

Flusso di dati nel grafico di filtro

Codici errore e esito positivo

Interfaccia IPin