Метод IMediaDet::p ut_Filter

Статья
07/28/2023

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

Примечание

[Не рекомендуется. Этот API можно удалить из будущих выпусков Windows.]

Метод put_Filter задает фильтр источника, используемый детектором мультимедиа.

Важно!

Не добавляйте исходный фильтр в собственный граф фильтров или используйте фильтр, который уже находится в графе фильтров. Объект детектора мультимедиа автоматически создает внутренний граф фильтра, и помещение фильтра в другой граф может привести к непредвиденным результатам.

Синтаксис

HRESULT put_Filter(
  [in] IUnknown *newVal
);

Параметры

newVal [in]: Указатель на интерфейс IUnknown исходного фильтра.

Возвращаемое значение

Возвращает значение HRESULT . Возможные значения:

Код возврата	Описание
S_OK	Успешно.
E_NOINTERFACE	newVal не указывает на фильтр.
E_POINTER	Аргумент указателя NULL.

Чтобы получить Qedit.h, скачайте обновление Microsoft Windows SDK для Windows Vista и платформа .NET Framework 3.0. Qedit.h недоступен в Microsoft Windows SDK для Windows 7 и платформа .NET Framework 3.5 с пакетом обновления 1 (SP1).

Требования

Требование	Значение
Заголовок	Qedit.h
Библиотека	Strmiids.lib

См. также раздел

Интерфейс IMediaDet
Коды ошибок и успешного выполнения

Поделиться через