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


Метод IAMTimelineEffectable::GetEffect

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

Примечание

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

 

Метод GetEffect извлекает эффект на указанном уровне приоритета.

Синтаксис

HRESULT GetEffect(
  [out] IAMTimelineObj **ppFX,
        long           Which
);

Параметры

ppFX [out]

Получает интерфейс IAMTimelineObj эффекта.

Который

Уровень приоритета извлекаемого эффекта.

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

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

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

 

Комментарии

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

Примечание

Файл заголовка Qedit.h несовместим с заголовками Direct3D более поздней версии 7.

 

Примечание

Чтобы получить 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

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

Интерфейс IAMTimelineEffectable

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