Sound Card Filter API

Sound Card Filter API
Sound Card api-manage Audio capture/play filters.
Functions

struct _msfilter * Ms_snd_card_create_reader (Mssndcard *obj)
struct _msfilter * Ms_snd_card_create_writer (Mssndcard *obj)
Mssndcard * Ms_snd_card_new (Mssndcarddesc *desc)
Mssndcard * Ms_snd_card_new_with_name (Mssndcarddesc *desc, const char *name)
void Ms_snd_card_destroy (Mssndcard *obj)
Mssndcard * Ms_snd_card_dup (Mssndcard *card)
const char * ms_snd_card_get_driver_type (const mssndcard *obj)
const char * ms_snd_card_get_name (const mssndcard *obj)
const char * ms_snd_card_get_string_id (Mssndcard *obj)
unsigned int ms_snd_card_get_capabilities (const mssndcard *obj)
void Ms_snd_card_set_level (Mssndcard *obj, Mssndcardmixerelem e, int percent)
int Ms_snd_card_get_level (Mssndcard *obj, Mssndcardmixerelem e)
void Ms_snd_card_set_capture (Mssndcard *obj, mssndcardcapture c)
int Ms_snd_card_set_control (Mssndcard *obj, Mssndcardcontrolelem e, int val)
int Ms_snd_card_get_control (Mssndcard *obj, Mssndcardcontrolelem e)
Mssndcard * Ms_alsa_card_new_custom (const char *pcmdev, const char *mixdev)
void ms_alsa_card_set_forced_sample_rate (int samplerate)
Function Documentation

struct _msfilter* ms_snd_card_create_reader (mssndcard * obj) [read]
Create an INPUT filter based on the selected sound card.

Parameters:
Obja sound card object.
Returns:a msfilter if successfull, NULL otherwise.

struct _msfilter* ms_snd_card_create_writer (mssndcard * obj) [read]
Create an ouput filter based on the selected sound card.

Parameters:
Obja sound card object.
Returns:a msfilter if successfull, NULL otherwise.

mssndcard* ms_snd_card_new (MSSNDCARDDESC * desc)
Create a new sound card object.

Parameters:
Desca sound card Description object.
Returns:mssndcard if successfull, NULL otherwise.

mssndcard* ms_snd_card_new_with_name (MSSNDCARDDESC * desc,
const char * name
)
Create a new sound card object.

Parameters:
Desca sound card Description object.
Cardmame
Returns:mssndcard if successfull, NULL otherwise.

void Ms_snd_card_destroy (Mssndcard * obj)
Destroy sound card object.

Parameters:
Obja Mssndcard object.
mssndcard* ms_snd_card_dup (Mssndcard * card)
Duplicate a sound card object.

This helps to open several time a sound card.

Parameters:
Carda sound card object.
Returns:mssndcard if successfull, NULL otherwise.

Const char* Ms_snd_card_get_driver_type (const mssndcard * obj)
Retreive a sound card ' s driver type string.

Internal driver types is either: "OSS, ALSA, winsnd, pasnd, CA"

Parameters:
Obja sound card object.
Returns:a string if successfull, NULL otherwise.

Const char* Ms_snd_card_get_name (const mssndcard * obj)
Retreive a sound card ' s name.

Parameters:
Obja sound card object.
Returns:a string if successfull, NULL otherwise.

Const char* ms_snd_card_get_string_id (Mssndcard * obj)
Retreive sound card ' s name (

Driver_type:
Name).

Parameters:
Obja sound card object.
Returns:a string if successfull, NULL otherwise.

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

Parameters:
Obja sound card object.
returns:a unsigned int if successfull, 0 otherwise.

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.

Parameters:
Obja sound card object.
EA sound card Mixer object.
Percenta volume level.
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.

Parameters:
Obja sound card object.
EA sound card Mixer object.
returns:a int if successfull, <0 otherwise.

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.

Parameters:
Obja sound card object.
CA sound card capture value.
returns:a int if successfull, 0 otherwise.

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.

Parameters:
Obja sound card object.
EA sound card Control object.
Percenta value for control.
returns:0 if successfull, <0 otherwise.

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.

Parameters:
Obja sound card object.
EA sound card Mixer object.
returns:a int if successfull, <0 otherwise.

mssndcard* ms_alsa_card_new_custom (const char * pcmdev,
const char * Mixdev
)
Create a ALSA card with user supplied PCM name and mixer name.

Parameters:
Pcmdevthe PCM device name following ALSA conventions (ex:plughw:0)
Mixdevthe Mixer Device Name following ALSA conventions.
Returns:a Mssndcard object, NULL if Alsa is not available.

void ms_alsa_card_set_forced_sample_rate (int samplerate)
Use supplied the sample rate to open ALSA devices (forced rate). has no interest except workarouding driver bugs. Use-1 to revert to normal behavior.

Sound Card Filter API