Metodo IMediaControl::AddSourceFilter (control.h)

[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 AddSourceFilter metodo aggiunge un filtro di origine al grafico dei filtri.

Questo metodo è destinato all'uso da parte delle applicazioni Visual Basic 6.0. È stato documentato per Visual Basic 6.0 come metodo FilgraphManager.AddSourceFilter . Le applicazioni C++ devono usare invece il metodo IGraphBuilder::AddSourceFilter .

Sintassi

HRESULT AddSourceFilter(
  [in]  BSTR      strFilename,
  [out] IDispatch **ppUnk
);

Parametri

[in] strFilename

Specifica il nome del file da caricare.

[out] ppUnk

Riceve un puntatore all'interfaccia IDispatch . Il chiamante deve rilasciare l'interfaccia. È possibile eseguire una query sul puntatore restituito per l'interfaccia IFilterInfo .

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

Vedi anche

Interfaccia IMediaControl