Interfaz IFileSourceFilter (strmif.h)

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

Los filtros de origen exponen la IFileSourceFilter interfaz para establecer el nombre de archivo y el tipo de medio del archivo multimedia que se van a representar. Es una versión abreviada de la interfaz COM IPersistFile . Si el archivo tiene un tipo que puede determinar el algoritmo descrito en Registro de un tipo de archivo personalizado, el CLSID de filtro de origen de archivo recomendado se usa cuando el administrador de gráficos de filtros intenta representar el gráfico de filtros.

Si un filtro necesita el nombre de un archivo para abrirlo, debe exponer esta interfaz para permitir que una aplicación establezca el nombre de archivo. Tenga en cuenta que no hay ninguna implementación de clase base de esta interfaz.

Una aplicación que inserte filtros de origen de archivo directamente debe consultar esta interfaz y establecer el nombre de archivo. Normalmente, el administrador de gráficos de filtros usa esta interfaz cuando una aplicación llama a IGraphBuilder::RenderFile. La herramienta Graphedt.exe consulta la interfaz IFileSourceFilter y solicita un nombre de archivo si lo encuentra.

Herencia

La interfaz IFileSourceFilter hereda de la interfaz IUnknown . IFileSourceFilter también tiene estos tipos de miembros:

Métodos

La interfaz IFileSourceFilter tiene estos métodos.

IFileSourceFilter::GetCurFile El método GetCurFile recupera el nombre y el tipo de medio del archivo actual. (IFileSourceFilter.GetCurFile)
IFileSourceFilter::Load El método Load hace que un filtro de origen cargue un archivo multimedia.

Requisitos

Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	strmif.h (incluye Dshow.h)