Метод CBaseRenderer.Receive

Метод Receive получает следующий пример мультимедиа в потоке.

Синтаксис

virtual Receive(
   IMediaSample *pMediaSample
);

Параметры

pMediaSample

Указатель на интерфейс IMediaSample примера.

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

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

Remarks

Входной контакт вызывает этот метод при получении образца из вышестоящего фильтра.

Если фильтр выполняется, этот метод выполняет следующие действия:

  1. Планирует отрисовку примера (CBaseRenderer::P repareReceive).
  2. Ожидает запланированного времени (CBaseRenderer::WaitForRenderTime).
  3. Отрисовывает пример (CBaseRenderer::Render).
  4. Освобождает пример (CBaseRenderer::ClearPendingSample).

Если фильтр приостановлен, метод выполняет следующие действия:

  1. Уведомляет производный класс о доступности примера (CBaseRenderer::OnReceiveFirstSample).
  2. Ожидает запланированного времени.
  3. Отрисовывает пример.
  4. Освобождает пример.

При приостановке метод ожидает на шаге 2, пока фильтр не перейдет в состояние выполнения. На этом этапе фильтр планирует выборку.

В базовом классе метод OnReceiveFirstSample ничего не делает. Производный класс может переопределить его. Например, если отрисовщик видео приостановлен, он отображает первый пример в виде изображения по-прежнему.

Требования

Требование Значение
Заголовок
Renbase.h (include Потоки.h)
Библиотека
Strmbase.lib (розничные сборки);
Strmbasd.lib (отладочные сборки)

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

Класс CBaseRenderer