mediastreamer2
2.10.0
|
MS2_PUBLIC struct _MSFilter* ms_snd_card_create_reader | ( | MSSndCard * | obj | ) |
Create an INPUT filter based on the selected sound card.
obj | A sound card object. |
Returns: A MSFilter if successfull, NULL otherwise.
MS2_PUBLIC struct _MSFilter* ms_snd_card_create_writer | ( | MSSndCard * | obj | ) |
Create an OUPUT filter based on the selected sound card.
obj | A sound card object. |
Returns: A MSFilter if successfull, NULL otherwise.
MS2_PUBLIC MSSndCard* ms_snd_card_new | ( | MSSndCardDesc * | desc | ) |
Create a new sound card object.
desc | A sound card description object. |
Returns: MSSndCard if successfull, NULL otherwise.
MS2_PUBLIC MSSndCard* ms_snd_card_new_with_name | ( | MSSndCardDesc * | desc, |
const char * | name | ||
) |
Create a new sound card object.
desc | A sound card description object. |
name | The card name |
Returns: MSSndCard if successfull, NULL otherwise.
MS2_PUBLIC void ms_snd_card_destroy | ( | MSSndCard * | obj | ) |
Destroy sound card object.
obj | A MSSndCard object. |
Duplicate a sound card object.
This helps to open several time a sound card.
card | A sound card object. |
Returns: MSSndCard if successfull, NULL otherwise.
MS2_PUBLIC const char* ms_snd_card_get_driver_type | ( | const MSSndCard * | obj | ) |
Retreive a sound card's driver type string.
Internal driver types are either: "OSS, ALSA, WINSND, PASND, CA"
obj | A sound card object. |
Returns: a string if successfull, NULL otherwise.
MS2_PUBLIC const char* ms_snd_card_get_name | ( | const MSSndCard * | obj | ) |
Retreive a sound card's name.
obj | A sound card object. |
Returns: a string if successfull, NULL otherwise.
MS2_PUBLIC const char* ms_snd_card_get_string_id | ( | MSSndCard * | obj | ) |
Retreive sound card's name (
name).
obj | A sound card object. |
Returns: A string if successfull, NULL otherwise.
MS2_PUBLIC unsigned int ms_snd_card_get_capabilities | ( | const MSSndCard * | obj | ) |
Retreive sound card's capabilities.
MS_SND_CARD_CAP_CAPTURE MS_SND_CARD_CAP_PLAYBACK MS_SND_CARD_CAP_CAPTURE|MS_SND_CARD_CAP_PLAYBACK MS_SND_CARD_CAP_BUILTIN_ECHO_CANCELLER
obj | A sound card object. |
Returns: A unsigned int if successfull, 0 otherwise.
MS2_PUBLIC int ms_snd_card_get_minimal_latency | ( | MSSndCard * | obj | ) |
Returns the sound card minimal latency (playback+record), in milliseconds. This value is to be used by the software echo cancellers to know where to search for the echo (optimization). Typically, an echo shall not be found before the value returned by this function. If this value is not known, then it should return 0.
obj | A sound card object. |
MS2_PUBLIC void ms_snd_card_set_level | ( | MSSndCard * | obj, |
MSSndCardMixerElem | e, | ||
int | percent | ||
) |
Set some mixer level value.
MS_SND_CARD_MASTER, MS_SND_CARD_PLAYBACK, MS_SND_CARD_CAPTURE
Note: not implemented on all sound card filters.
obj | A sound card object. |
e | A sound card mixer object. |
percent | A volume level. |
MS2_PUBLIC int ms_snd_card_get_level | ( | MSSndCard * | obj, |
MSSndCardMixerElem | e | ||
) |
Get some mixer level value.
MS_SND_CARD_MASTER, MS_SND_CARD_PLAYBACK, MS_SND_CARD_CAPTURE
Note: not implemented on all sound card filters.
obj | A sound card object. |
e | A sound card mixer object. |
Returns: A int if successfull, <0 otherwise.
MS2_PUBLIC void ms_snd_card_set_capture | ( | MSSndCard * | obj, |
MSSndCardCapture | c | ||
) |
Set some source for capture.
MS_SND_CARD_MIC, MS_SND_CARD_LINE
Note: not implemented on all sound card filters.
obj | A sound card object. |
c | A sound card capture value. |
Returns: A int if successfull, 0 otherwise.
MS2_PUBLIC int ms_snd_card_set_control | ( | MSSndCard * | obj, |
MSSndCardControlElem | e, | ||
int | val | ||
) |
Set some mixer control.
MS_SND_CARD_MASTER_MUTE, -> 0: unmute, 1: mute MS_SND_CARD_PLAYBACK_MUTE, -> 0: unmute, 1: mute MS_SND_CARD_CAPTURE_MUTE -> 0: unmute, 1: mute
Note: not implemented on all sound card filters.
obj | A sound card object. |
e | A sound card control object. |
val | A value for control. |
Returns: 0 if successfull, <0 otherwise.
MS2_PUBLIC int ms_snd_card_get_control | ( | MSSndCard * | obj, |
MSSndCardControlElem | e | ||
) |
Get some mixer control.
MS_SND_CARD_MASTER_MUTE, -> return 0: unmute, 1: mute MS_SND_CARD_PLAYBACK_MUTE, -> return 0: unmute, 1: mute MS_SND_CARD_CAPTURE_MUTE -> return 0: unmute, 1: mute
Note: not implemented on all sound card filters.
obj | A sound card object. |
e | A sound card mixer object. |
Returns: A int if successfull, <0 otherwise.
MS2_PUBLIC int ms_snd_card_get_preferred_sample_rate | ( | const MSSndCard * | obj | ) |
Get preferred sample rate
obj | A sound card object. |
Returns: return sample rate in khz
MS2_PUBLIC int ms_snd_card_set_preferred_sample_rate | ( | MSSndCard * | obj, |
int | rate | ||
) |
set preferred sample rate. The underlying card will try to avoid any resampling for this samplerate.
obj | A sound card object. |
rate | sampling rate. |
Returns: 0 if successfull, <0 otherwise.
MS2_PUBLIC void ms_snd_card_set_usage_hint | ( | MSSndCard * | obj, |
bool_t | is_going_to_be_used | ||
) |
Enable application to tell that the soundcard is going to be used or will cease to be used. This is recommended for cards which are known to be slow (see flag MS_SND_CARD_CAP_IS_SLOW ).
MS2_PUBLIC MSSndCard* ms_alsa_card_new_custom | ( | const char * | pcmdev, |
const char * | mixdev | ||
) |
Create a alsa card with user supplied pcm name and mixer name.
pcmdev | The pcm device name following alsa conventions (ex: plughw:0) |
mixdev | The mixer device name following alsa conventions. |
Returns: a MSSndCard object, NULL if alsa support is not available.
MS2_PUBLIC void ms_alsa_card_set_forced_sample_rate | ( | int | samplerate | ) |
Use supplied sample rate to open alsa devices (forced rate). Has no interest except workarouding driver bugs. Use -1 to revert to normal behavior.