Интерфейс IFileSourceFilter (strmif.h)

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]

Интерфейс IFileSourceFilter предоставляется фильтрами источника, чтобы задать имя файла и тип носителя файла мультимедиа, который они должны отображать. Это сокращенная версия интерфейса COM IPersistFile . Если файл имеет тип, который можно определить с помощью алгоритма, описанного в разделе Регистрация настраиваемого типа файла, рекомендуемый фильтр источника файлов CLSID используется, когда диспетчер графа фильтров пытается отобразить граф фильтра.

Если фильтру требуется открыть имя файла, он должен предоставить этот интерфейс, чтобы позволить приложению задать имя файла. Обратите внимание, что реализация этого интерфейса в базовом классе отсутствует.

Приложение, которое вставляет фильтры источника файлов напрямую, должно запрашивать этот интерфейс и задавать имя файла. Как правило, диспетчер графов фильтров использует этот интерфейс, когда приложение вызывает IGraphBuilder::RenderFile. Средство Graphedt.exe запрашивает интерфейс IFileSourceFilter и запрашивает имя файла, если он его найдет.

Наследование

Интерфейс IFileSourceFilter наследуется от интерфейса IUnknown . IFileSourceFilter также имеет следующие типы членов:

Методы

Интерфейс IFileSourceFilter содержит следующие методы.

IFileSourceFilter::GetCurFile Метод GetCurFile извлекает имя и тип носителя текущего файла. (IFileSourceFilter.GetCurFile)
IFileSourceFilter::Load Метод Load приводит к загрузке файла мультимедиа фильтром источника.

Требования

Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	strmif.h (включая Dshow.h)