Condividi tramite


Interfaccia IFileSourceFilter (strmif.h)

[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.

L'interfaccia IFileSourceFilter viene esposta dai filtri di origine per impostare il nome del file e il tipo di supporto del file multimediale da eseguire per il rendering. È una versione abbreviata dell'interfaccia IPersistFile COM. Se il file ha un tipo che può essere determinato dall'algoritmo descritto in Registrazione di un tipo di file personalizzato, il clSID del filtro di origine file consigliato viene usato quando la gestione dei grafici di filtro tenta di eseguire il rendering del grafico del filtro.

Se un filtro richiede il nome di un file da aprire, deve esporre questa interfaccia per consentire a un'applicazione di impostare il nome del file. Si noti che non esiste alcuna implementazione della classe di base di questa interfaccia.

Un'applicazione che inserisce i filtri di origine file direttamente deve eseguire query per questa interfaccia e impostare il nome del file. In genere, la gestione dei grafici di filtro usa questa interfaccia quando un'applicazione chiama IGraphBuilder::RenderFile. Lo strumento Graphedt.exe esegue query per l'interfaccia IFileSourceFilter e richiede un nome file se lo trova.

Ereditarietà

L'interfaccia IFileSourceFilter eredita dall'interfaccia IUnknown . IFileSourceFilter include anche questi tipi di membri:

Metodi

L'interfaccia IFileSourceFilter include questi metodi.

 
IFileSourceFilter::GetCurFile

Il metodo GetCurFile recupera il nome e il tipo di supporto del file corrente. (IFileSourceFilter.GetCurFile)
IFileSourceFilter::Load

Il metodo Load causa il caricamento di un file multimediale da parte di un filtro di origine.

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)