gstaudiosrc — Simple base class for audio sources


#include <gst/audio/gstaudiosrc.h>

struct              GstAudioSrc;
struct              GstAudioSrcClass;

Object Hierarchy



This is the most simple base class for audio sources that only requires subclasses to implement a set of simple functions:


Open the device.


Configure the device with the specified format.


Read samples from the device.


Unblock reads and flush the device.


Get the number of samples in the device but not yet read.


Undo operations done by prepare.


Close the device.

All scheduling of samples and timestamps is done in this base class together with GstAudioBaseSrc using a default implementation of a GstAudioRingBuffer that uses threads.

Last reviewed on 2006-09-27 (0.10.12)


struct GstAudioSrc

struct GstAudioSrc;

Base class for simple audio sources.

struct GstAudioSrcClass

struct GstAudioSrcClass {
  GstAudioBaseSrcClass parent_class;

  /* vtable */

  /* open the device with given specs */
  gboolean (*open)      (GstAudioSrc *src);
  /* prepare resources and state to operate with the given specs */
  gboolean (*prepare)   (GstAudioSrc *src, GstAudioRingBufferSpec *spec);
  /* undo anything that was done in prepare() */
  gboolean (*unprepare) (GstAudioSrc *src);
  /* close the device */
  gboolean (*close)     (GstAudioSrc *src);
  /* read samples from the device */
  guint    (*read)      (GstAudioSrc *src, gpointer data, guint length,
      GstClockTime *timestamp);
  /* get number of samples queued in the device */
  guint    (*delay)     (GstAudioSrc *src);
  /* reset the audio device, unblock from a write */
  void     (*reset)     (GstAudioSrc *src);

GstAudioSrc class. Override the vmethod to implement functionality.

GstAudioBaseSrcClass parent_class;

the parent class.

open ()

open the device with the specified caps

prepare ()

configure device with format

unprepare ()

undo the configuration

close ()

close the device

read ()

read samples to the audio device

delay ()

the number of samples queued in the device

reset ()

unblock a read to the device and reset.

See Also

GstAudioBaseSrc, GstAudioRingBuffer, GstAudioSrc.