Usando o Localizador de Mídia
[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]
[Não há suporte para essa API e pode ser alterada ou indisponível no futuro.]
O localizador de mídia é um objeto auxiliar que verifica nomes de arquivo e procura arquivos ausentes em diretórios locais ou de rede. O detector de mídia mantém um cache de caminhos de diretório em que encontrou arquivos com êxito em pesquisas passadas. Para localizar um arquivo, ele pesquisa os diretórios em seu cache. Caso contrário, o detector de mídia pode exibir uma caixa de diálogo Abrir Arquivo para o usuário localizar um arquivo manualmente. Supondo que o usuário localize o arquivo, o localizador de mídia adiciona o novo diretório ao seu cache. O localizador de mídia expõe a interface IMediaLocator .
Normalmente, seu aplicativo não cria diretamente uma instância do localizador de mídia. Em vez disso, o linha do tempo e o mecanismo de renderização fornecem os métodos a seguir para validar nomes de arquivo usando o detector de mídia.
- Para validar nomes de arquivo no linha do tempo, chame IAMTimeline::ValidateSourceNames. Opcionalmente, esse método também atualiza os objetos de origem com os nomes de arquivo corretos.
- Para validar nomes de arquivo quando o projeto for renderizado, chame IRenderEngine::SetSourceNameValidation.
Ambos os métodos assumem sinalizadores que controlam o comportamento do localizador de mídia. Por exemplo, você pode restringir a pesquisa a diretórios locais.
Tópicos relacionados