Interface IFileSinkFilter (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 IFileSinkFilter interface é implementada em filtros que gravam fluxos de mídia em um arquivo. Um filtro de coletor de arquivos em um grafo de filtro de captura de vídeo, por exemplo, grava a saída do filtro de compactação de vídeo em um arquivo. Normalmente, o aplicativo que executa esse grafo de filtro deve permitir que o usuário insira o nome do arquivo a ser gravado. Essa interface permite a comunicação dessas informações.
Se um filtro precisar do nome de um arquivo de saída, ele deverá expor essa interface para permitir que um aplicativo defina o nome do arquivo. Observe que atualmente não há nenhuma implementação de classe base dessa interface.
Qualquer aplicativo que precise definir o nome do arquivo no qual o filtro do coletor de arquivos será gravado deve usar essa interface para obter e definir o nome do arquivo.
Herança
A interface IFileSinkFilter herda da interface IUnknown . IFileSinkFilter também tem estes tipos de membros:
Métodos
A interface IFileSinkFilter tem esses métodos.
| IFileSinkFilter::GetCurFile O método GetCurFile recupera o nome e o tipo de mídia do arquivo atual. (IFileSinkFilter.GetCurFile) |
| IFileSinkFilter::SetFileName O método SetFileName define o nome do arquivo no qual os exemplos de mídia serão gravados. |
Comentários
A interface IFileSinkFilter2 estende IFileSinkFilter.
Requisitos
| Requisito | Valor |
|---|---|
| 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) |