Interface IFileSinkFilter2 (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 interface IFileSinkFilter2 estende a interface IFileSinkFilter . Filtros que gravam fluxos de mídia em um arquivo implementam essa interface. Um filtro de coletor de arquivos em um grafo de filtro de captura de vídeo, por exemplo, salva 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 no qual salvar os dados. Essa interface permite que você comunique essas informações.

IFileSinkFilter2 adiciona a opção para determinar se o arquivo que ele grava deve destruir um arquivo existente de mesmo nome. No caso de captura de vídeo, não destrua um arquivo que você já criou, pois a pré-alocação do espaço de arquivo leva um tempo valioso. Por padrão, o novo arquivo não destrói o antigo. Caso contrário, destrua o arquivo original para garantir que o arquivo criado não contenha lixo.

Herança

A interface IFileSinkFilter2 herda de IFileSinkFilter. IFileSinkFilter2 também tem estes tipos de membros:

Métodos

A interface IFileSinkFilter2 tem esses métodos.

 
IFileSinkFilter2::GetMode

O método GetMode recupera se o gravador de arquivos destrói o arquivo quando ele cria o novo.
IFileSinkFilter2::SetMode

O método SetMode determina se o gravador de arquivos destrói o arquivo quando ele cria o novo.

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

Ifilesinkfilter

Interfaces