Метод IOverlay::Advise (strmif.h)

Статья
07/28/2023

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

Метод Advise настраивает ссылку для получения рекомендаций для событий наложения, указанных параметром dwInterests .

Синтаксис

HRESULT Advise(
  [in] IOverlayNotify *pOverlayNotify,
  [in] DWORD          dwInterests
);

Параметры

[in] pOverlayNotify

Указатель на интерфейс уведомлений.

[in] dwInterests

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

Событие	Описание
ADVISE_NONE	Без изменений.
ADVISE_CLIPPING	Изменение области обрезки (синхронизировано с окном).
ADVISE_PALETTE	Изменение палитры.
ADVISE_COLORKEY	Изменение значения ключа хрома.
ADVISE_POSITION	Изменение положения окна видео (не синхронизировано с окном).
ADVISE_DISPLAY_CHANGE	Вызвали WM_DISPLAYCHANGE. Сообщение WM_DISPLAYCHANGE отправляется во все окна при изменении разрешения экрана.
ADVISE_ALL2	Все вышеперечисленное.

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

В случае успешного выполнения возвращает S_OK. Если метод завершается ошибкой, он возвращает код ошибки HRESULT .

Этот метод настраивает ссылку для получения уведомлений для интерфейса IOverlayNotify . Если происходит одно из этих событий, вызывается соответствующая точка входа в переданном параметре pOverlayNotify (IOverlayNotify::OnClipChange, IOverlayNotify::OnColorKeyChange, IOverlayNotify::OnPaletteChange или IOverlayNotify::OnPositionChange).

Для любого заданного интерфейса IOverlay можно установить только одну ссылку на совет. Попытка задать другой интерфейс уведомлений во втором и последующих вызовах возвращает VFW_E_ADVISE_ALREADY_SET. Ссылку на рекомендации можно отменить с помощью IOverlay::Unadvise.

Требования

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

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

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

Интерфейс IOverlay

Share via