Метод IVideoFrameStep::CanStep (strmif.h)

Статья
07/28/2023

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

Метод CanStep определяет возможности пошагового выполнения указанного фильтра.

Синтаксис

HRESULT CanStep(
  long     bMultiple,
  IUnknown *pStepObject
);

Параметры

bMultiple

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

pStepObject

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

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

Возвращает S_OK, если объект может выполнять шаг, или E_INVALIDARG, если pStepObject является недопустимым.

Требования

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

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

Коды ошибок и успешного выполнения

Интерфейс IVideoFrameStep

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