Metodo IFilterGraph::D isconnect (strmif.h)

  • Articolo

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine 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, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il Disconnect metodo disconnette questo pin.

Sintassi

HRESULT Disconnect(
  [in] IPin *ppin
);

Parametri

[in] ppin

Puntatore al pin per disconnettersi.

Valore restituito

Restituisce uno dei valori seguenti.

Codice restituito Descrizione
S_OK
 Operazione completata.
S_FALSE
 Il pin non è stato connesso. Nessun errore.
E_FAIL
 Esito negativo.
E_POINTER
 Argomento puntatore NULL.
VFW_E_NOT_STOPPED
 Il filtro non viene arrestato, ma non supporta la riconnessione in uno stato in esecuzione.

Commenti

Questo metodo non interrompe completamente la connessione. Per interrompere completamente la connessione, è necessario disconnettere entrambe le estremità.

Per rimuovere completamente un filtro dal grafico del filtro, chiamare il metodo IFilterGraph::RemoveFilter .

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 di errore e di esito positivo

Interfaccia IFilterGraph