Interface IFileSinkFilter2 (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 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) |