Interface IFileSinkFilter (strmif.h)

  • Artigo

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

Confira também

Interfaces