struct GstTypeFind

struct GstTypeFind {

  /* private to the caller of the typefind function */
  guint8 *		(* peek)			(gpointer		data,
							 gint64	         	offset,
							 guint			size);
  void			(* suggest)			(gpointer		data,
							 guint			probability,
							 const GstCaps *		caps);
  
  gpointer			data;
  
  /* optional */
  guint64		(* get_length)			(gpointer		data);

};

GstTypeFindFunction ()

void        (*GstTypeFindFunction)          (GstTypeFind *find,
                                             gpointer data);

enum GstTypeFindProbability

typedef enum {
  GST_TYPE_FIND_MINIMUM = 1,
  GST_TYPE_FIND_POSSIBLE = 50,
  GST_TYPE_FIND_LIKELY = 80,
  GST_TYPE_FIND_NEARLY_CERTAIN = 99,
  GST_TYPE_FIND_MAXIMUM = 100
} GstTypeFindProbability;

gst_type_find_peek ()

guint8*     gst_type_find_peek              (GstTypeFind *find,
                                             gint64 offset,
                                             guint size);

Returns size bytes of the stream to identify beginning at offset. If offset is a positive number, the offset is relative to the beginning of the stream, if offset is a negative number the offset is relative to the end of the stream. The returned memory is valid until the typefinding function returns and must not be freed. If NULL is returned, that data is not available.

gst_type_find_suggest ()

void        gst_type_find_suggest           (GstTypeFind *find,
                                             guint probability,
                                             const GstCaps *caps);

If a typefind function calls this function it suggests the caps with the given probability. A typefind function may supply different suggestions in one call. It is up to the caller of the typefind function to interpret these values.

gst_type_find_get_length ()

guint64     gst_type_find_get_length        (GstTypeFind *find);

Get the length of the data stream.

gst_type_find_register ()

gboolean    gst_type_find_register          (GstPlugin *plugin,
                                             const gchar *name,
                                             guint rank,
                                             GstTypeFindFunction func,
                                             gchar **extensions,
                                             const GstCaps *possible_caps,
                                             gpointer data);

Registers a new typefind function to be used for typefinding. After registering this function will be available for typefinding. This function is typically called during an element's plugin initialization.