libs/gst/net/gstnetaddressmeta.c

   1 /* GStreamer
   2  * Copyright (C) <2011> Wim Taymans <wim.taymans@gmail.com>
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Library General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Library General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Library General Public
  15  * License along with this library; if not, write to the
  16  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  17  * Boston, MA 02111-1307, USA.
  18  */
  19
  20 /**
  21  * SECTION:gstnetaddressmeta
  22  * @short_description: Network address metadata
  23  *
  24  * #GstNetAddress can be used to store a network address. #GstNetAddressMeta can
  25  * be used to store a network address in a #GstBuffer so that it network
  26  * elements can track the to and from address of the buffer.
  27  *
  28  * Last reviewed on 2011-11-03 (0.11.2)
  29  */
  30
  31 #include <string.h>
  32
  33 #include "gstnetaddressmeta.h"
  34
  35 static gboolean
  36 net_address_meta_init (GstNetAddressMeta * meta, gpointer params,
  37     GstBuffer * buffer)
  38 {
  39   meta->addr = NULL;
  40
  41   return TRUE;
  42 }
  43
  44 static void
  45 net_address_meta_transform (GstBuffer * transbuf, GstNetAddressMeta * meta,
  46     GstBuffer * buffer, GQuark type, gpointer data)
  47 {
  48   /* we always copy no matter what transform */
  49   gst_buffer_add_net_address_meta (transbuf, meta->addr);
  50 }
  51
  52 static void
  53 net_address_meta_free (GstNetAddressMeta * meta, GstBuffer * buffer)
  54 {
  55   if (meta->addr)
  56     g_object_unref (meta->addr);
  57   meta->addr = NULL;
  58 }
  59
  60 const GstMetaInfo *
  61 gst_net_address_meta_get_info (void)
  62 {
  63   static const GstMetaInfo *meta_info = NULL;
  64
  65   if (meta_info == NULL) {
  66     meta_info = gst_meta_register ("GstNetAddressMeta", "GstNetAddressMeta",
  67         sizeof (GstNetAddressMeta),
  68         (GstMetaInitFunction) net_address_meta_init,
  69         (GstMetaFreeFunction) net_address_meta_free,
  70         (GstMetaTransformFunction) net_address_meta_transform);
  71   }
  72   return meta_info;
  73 }
  74
  75 GstNetAddressMeta *
  76 gst_buffer_add_net_address_meta (GstBuffer * buffer, GSocketAddress * addr)
  77 {
  78   GstNetAddressMeta *meta;
  79
  80   g_return_val_if_fail (GST_IS_BUFFER (buffer), NULL);
  81   g_return_val_if_fail (G_IS_SOCKET_ADDRESS (addr), NULL);
  82
  83   meta =
  84       (GstNetAddressMeta *) gst_buffer_add_meta (buffer,
  85       GST_NET_ADDRESS_META_INFO, NULL);
  86
  87   meta->addr = g_object_ref (addr);
  88
  89   return meta;
  90 }