Compartilhar via


Interface IFileSourceFilter (strmif.h)

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

A IFileSourceFilter interface é exposta por filtros de origem para definir o nome do arquivo e o tipo de mídia do arquivo de mídia que eles devem renderizar. É uma versão abreviada da interface COM IPersistFile . Se o arquivo tiver um tipo que pode ser determinado pelo algoritmo descrito em Registrando um tipo de arquivo personalizado, o filtro de origem de arquivo recomendado CLSID será usado quando o gerenciador de grafo de filtro tentar renderizar o grafo de filtro.

Se um filtro precisar do nome de um arquivo para abrir, ele deverá expor essa interface para permitir que um aplicativo defina o nome do arquivo. Observe que não há nenhuma implementação de classe base dessa interface.

Um aplicativo que insere filtros de origem de arquivo diretamente deve consultar essa interface e definir o nome do arquivo. Normalmente, o gerenciador de grafo de filtro usa essa interface quando um aplicativo chama IGraphBuilder::RenderFile. A ferramenta Graphedt.exe consulta a interface IFileSourceFilter e solicita um nome de arquivo se a encontrar.

Herança

A interface IFileSourceFilter herda da interface IUnknown . IFileSourceFilter também tem estes tipos de membros:

Métodos

A interface IFileSourceFilter tem esses métodos.

 
IFileSourceFilter::GetCurFile

O método GetCurFile recupera o nome e o tipo de mídia do arquivo atual. (IFileSourceFilter.GetCurFile)
IFileSourceFilter::Load

O método Load faz com que um filtro de origem carregue um arquivo de mídia.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho strmif.h (inclua Dshow.h)