Uso del localizzatore multimediale
[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.
[Questa API non è supportata e può essere modificata o non disponibile in futuro.]
Il localizzatore multimediale è un oggetto helper che verifica i nomi dei file e cerca i file mancanti nelle directory locali o di rete. Il rilevatore multimediale mantiene una cache dei percorsi di directory in cui ha trovato correttamente i file nelle ricerche precedenti. Per individuare un file, cerca le directory nella cache. In caso contrario, il rilevatore multimediale può visualizzare una finestra di dialogo Apri file per l'utente per individuare manualmente un file. Supponendo che l'utente individua il file, il localizzatore multimediale aggiunge la nuova directory alla relativa cache. Il localizzatore multimediale espone l'interfaccia IMediaLocator .
In genere, l'applicazione non crea direttamente un'istanza del localizzatore multimediale. Al contrario, la sequenza temporale e il motore di rendering forniscono i metodi seguenti per convalidare i nomi di file usando il rilevamento dei supporti.
- Per convalidare i nomi di file nella sequenza temporale, chiamare IAMTimeline::ValidateSourceNames. Facoltativamente, questo metodo aggiorna anche gli oggetti di origine con i nomi di file corretti.
- Per convalidare i nomi di file quando viene eseguito il rendering del progetto, chiamare IRenderEngine::SetSourceNameValidation.
Entrambi i metodi accettano flag che controllano il comportamento del localizzatore multimediale. Ad esempio, è possibile limitare la ricerca alle directory locali.
Argomenti correlati