Интерфейс IFileSinkFilter (strmif.h)
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]
Интерфейс IFileSinkFilter реализуется в фильтрах, которые записывают потоки мультимедиа в файл. Например, фильтр приемника файлов в графе фильтра захвата видео записывает выходные данные фильтра сжатия видео в файл. Как правило, приложение, выполняющее этот граф фильтра, должно позволить пользователю ввести имя файла для записи. Этот интерфейс обеспечивает обмен этой информацией.
Если фильтру требуется имя выходного файла, он должен предоставлять этот интерфейс, чтобы разрешить приложению задать имя файла. Обратите внимание, что в настоящее время реализация этого интерфейса в базовом классе отсутствует.
Любое приложение, которое должно задать имя файла, в который будет записываться фильтр приемника файлов, должно использовать этот интерфейс для получения и задания имени файла.
Наследование
Интерфейс IFileSinkFilter наследуется от интерфейса IUnknown . IFileSinkFilter также имеет следующие типы элементов:
Методы
Интерфейс IFileSinkFilter содержит следующие методы.
| IFileSinkFilter::GetCurFile Метод GetCurFile извлекает имя и тип носителя текущего файла. (IFileSinkFilter.GetCurFile) |
| IFileSinkFilter::SetFileName Метод SetFileName задает имя файла, в который будут записываться примеры мультимедиа. |
Комментарии
Интерфейс IFileSinkFilter2 расширяет IFileSinkFilter.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | strmif.h (включая Dshow.h) |