Changeset 2438 for pjproject/branches/projects/aps-direct/pjmedia/include/pjmedia/sound_port.h

Timestamp:

Feb 5, 2009 10:59:14 AM (15 years ago)

Author:

nanang

Message:

• Added new API for sound & sound port to create/open sound device with extended setting, to allow opening sound device with non-PCM format and other settings.
• Updated symbian_ua/ua.cpp to be able to reopen sound device when audio stream session is using non-PCM data/passthrough codec.
• Updated stream.c to allow it works with non-PCM data.
• Added PCMU/A frames processing into non-PCM play/record callbacks in symbian_audio_aps.cpp.
• Added passthrough codec init/deinitialization in pjsua-lib.
• Added a new pjmedia_frame_ext helper function, pjmedia_frame_ext_pop_subframes, to pop-out/remove some subframes.
• Other minor updates/fixes.

File:

• pjproject/branches/projects/aps-direct/pjmedia/include/pjmedia/sound_port.h (modified) (1 diff)

pjproject/branches/projects/aps-direct/pjmedia/include/pjmedia/sound_port.h

@@ -160 +160 @@
                                                     unsigned options,
                                                     pjmedia_snd_port **p_port);
-                                              
+
+
+/**
+ * Create unidirectional or bidirectional sound port. This also allows
+ * creating sound port with extended settings, e.g: audio format, see 
+ * #pjmedia_snd_setting.
+ *
+ * @param pool              Pool to allocate sound port structure.
+ * @param dir               Sound device direction.
+ * @param rec_id            Device index for recorder/capture stream, or
+ *                          -1 to use the first capable device.
+ * @param play_id           Device index for playback stream, or -1 to use 
+ *                          the first capable device.
+ * @param clock_rate        Sound device's clock rate to set.
+ * @param channel_count     Set number of channels, 1 for mono, or 2 for
+ *                          stereo. The channel count determines the format
+ *                          of the frame.
+ * @param samples_per_frame Number of samples per frame.
+ * @param bits_per_sample   Set the number of bits per sample. The normal 
+ *                          value for this parameter is 16 bits per sample.
+ * @param setting           Sound device extended settings, see 
+ *                          #pjmedia_snd_setting.
+ * @param p_port            Pointer to receive the sound device port instance.
+ *
+ * @return                  PJ_SUCCESS on success, or the appropriate error
+ *                          code.
+ */
+PJ_DECL(pj_status_t) pjmedia_snd_port_create2(pj_pool_t *pool,
+                                              pjmedia_dir dir,
+                                              int rec_id,
+                                              int play_id,
+                                              unsigned clock_rate,
+                                              unsigned channel_count,
+                                              unsigned samples_per_frame,
+                                              unsigned bits_per_sample,
+                                              const pjmedia_snd_setting *setting,
+                                              pjmedia_snd_port **p_port);
+
 
 /**