Наши партнеры

Библиотека сайта rus-linux.net

Фреймворк GStreamer. Руководство разработчика плагинов. Функция обработки запросов

Оригинал: GStreamer Plugin Writer's Guide
Авторы: Richard John Boulton, Erik Walthinsen, Steve Baker, Leif Johnson, Ronald S. Bultje, Stefan Kost, Tim-Philipp Muller, Wim Taymans
Дата публикации: 19 июля 2014 г.
Перевод: А.Панин
Дата перевода: 26 июля 2014 г.

Глава 7. Функция обработки запросов

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

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

static gboolean gst_my_filter_src_query (GstPad    *pad,
                                         GstObject *parent,
                                         GstQuery  *query);

[..]

static void
gst_my_filter_init (GstMyFilter * filter)
{
[..]
  /* настройка функции обработки событий точки соединения перед
   * добавлением точки соединения в элемент */
  gst_pad_set_query_function (filter->srcpad,
      gst_my_filter_src_query);
[..]
}

static gboolean
gst_my_filter_src_query (GstPad    *pad,
		         GstObject *parent,
		         GstQuery  *query)
{
  gboolean ret;
  GstMyFilter *filter = GST_MY_FILTER (parent);

switch (GST_QUERY_TYPE (query)) {
    case GST_QUERY_POSITION:
      /* мы должны сообщить о текущей позиции в мультимедийном потоке */
      [...]
      break;
    case GST_QUERY_DURATION:
      /* здесь мы должны сообщить о продолжительности мультимедийного потока */
      [...]
      break;
    case GST_QUERY_CAPS:
      /* здесь мы должны сообщить о поддерживаемых возможностях */
      [...]
      break;
    default:
      /* простой вызов стандартного обработчика запросов */
      ret = gst_pad_query_default (pad, parent, query);
      break;
  }
  return ret;
}

Хорошей идеей является вызов стандартного обработчика запросов gst_pad_query_default () для обработки неизвестных запросов. В зависимости от типа запроса стандартный обработчик запросов либо предаст запрос далее по конвейеру, либо просто удалит ссылку на него.

Следующий раздел : Обзор состояний.