Interfaz IFileSinkFilter (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.
La IFileSinkFilter interfaz se implementa en filtros que escriben secuencias multimedia en un archivo. Un filtro receptor de archivos en un gráfico de filtros de captura de vídeo, por ejemplo, escribe la salida del filtro de compresión de vídeo en un archivo. Normalmente, la aplicación que ejecuta este gráfico de filtros debe permitir al usuario escribir el nombre del archivo en el que se va a escribir. Esta interfaz permite la comunicación de esta información.
Si un filtro necesita el nombre de un archivo de salida, debe exponer esta interfaz para permitir que una aplicación establezca el nombre de archivo. Tenga en cuenta que actualmente no hay ninguna implementación de clase base de esta interfaz.
Cualquier aplicación que deba establecer el nombre del archivo en el que escribirá el filtro receptor de archivos debe usar esta interfaz para obtener y establecer el nombre de archivo.
Herencia
La interfaz IFileSinkFilter hereda de la interfaz IUnknown . IFileSinkFilter también tiene estos tipos de miembros:
Métodos
La interfaz IFileSinkFilter tiene estos métodos.
| IFileSinkFilter::GetCurFile El método GetCurFile recupera el nombre y el tipo de medio del archivo actual. (IFileSinkFilter.GetCurFile) |
| IFileSinkFilter::SetFileName El método SetFileName establece el nombre del archivo en el que se escribirán ejemplos multimedia. |
Comentarios
La interfaz IFileSinkFilter2 extiende IFileSinkFilter.
Requisitos
| Requisito | Value |
|---|---|
| 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 (incluya Dshow.h) |