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

Метод IGraphConfig::SetFilterFlags (strmif.h)

  • Статья

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

Метод SetFilterFlags задает сведения о конфигурации фильтра.

Синтаксис

HRESULT SetFilterFlags(
  [in] IBaseFilter *pFilter,
  [in] DWORD       dwFlags
);

Параметры

[in] pFilter

Указатель на интерфейс IBaseFilter фильтра в графе фильтра.

[in] dwFlags

Значение, указывающее новые флаги конфигурации. Необходимо установить одно из следующих значений.

Значение Описание
Ноль Флаги не заданы.
AM_FILTER_FLAGS_REMOVABLE Фильтр является съемным во время динамического повторного подключения. Дополнительные сведения см. в подразделе "Примечания".

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

Возвращает одно из следующих значений HRESULT .

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

Комментарии

Флаг AM_FILTER_FLAGS_REMOVABLE изменяет поведение метода IGraphConfig::Reconnect . Метод Reconnect выполняет динамическое повторное подключение между двумя контактами. Если вызывающий объект задает один контакт, но не указывает другой, повторное подключение выполняет поиск вышестоящий или ниже указанного контакта, чтобы найти подходящее совпадение. Однако по умолчанию поиск завершается ошибкой, если он достигает фильтра, добавленного в граф с помощью метода IFilterGraph::AddFilter . Чтобы переопределить это поведение, вызовите SetFilterFlags и установите флаг AM_FILTER_FLAGS_REMOVABLE фильтра.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header strmif.h (включая Dshow.h)
Библиотека Strmiids.lib

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

Коды ошибок и успешности

Интерфейс IGraphConfig