Changeset 744 for pjproject/trunk/pjmedia/include/pjmedia/sound.h

Timestamp:

Sep 27, 2006 10:49:55 PM (18 years ago)

Author:

bennylp

Message:

Added pjmedia_snd_stream_get_info() function.

NOTE SOUND DEVICE IMPLEMENTORS: YOU'LL NEED TO IMPLEMENT THIS

FUNCTION TOO *

File:

• pjproject/trunk/pjmedia/include/pjmedia/sound.h (modified) (2 diffs)

pjproject/trunk/pjmedia/include/pjmedia/sound.h

@@ -74 +74 @@
     unsigned    default_samples_per_sec;/**< Default sampling rate.         */
 } pjmedia_snd_dev_info;
+
+/** 
+ * Stream information, can be retrieved from a live stream by calling
+ * #pjmedia_snd_stream_get_info().
+ */
+typedef struct pjmedia_snd_stream_info
+{
+    pjmedia_dir dir;                /**< Stream direction.                  */
+    int         play_id;            /**< Playback dev id, or -1 for rec only*/
+    int         rec_id;             /**< Capture dev id, or -1 for play only*/
+    unsigned    clock_rate;         /**< Actual clock rate.                 */
+    unsigned    channel_count;      /**< Number of channels.                */
+    unsigned    samples_per_frame;  /**< Samples per frame.                 */
+    unsigned    bits_per_sample;    /**< Bits per sample.                   */
+    unsigned    rec_latency;        /**< Record latency, in samples.        */
+    unsigned    play_latency;       /**< Playback latency, in samples.      */
+} pjmedia_snd_stream_info;
+
 
 /** 
@@ -233 +251 @@
 
 /**
+ * Get information about live stream.
+ *
+ * @param strm          The stream to be queried.
+ * @param i             Pointer to stream information to be filled up with
+ *                      information about the stream.
+ *
+ * @return              PJ_SUCCESS on success or the appropriate error code.
+ */
+PJ_DECL(pj_status_t) pjmedia_snd_stream_get_info(pjmedia_snd_stream *strm,
+                                                 pjmedia_snd_stream_info *pi);
+
+
+/**
  * Start the stream.
  *