AudioOutputStart

From TrillWiki

The audioOutputStart function will actually start a stream which has been initialized with audioOutputInitialize.

Compatibility: 3.0 and higher

Contents 1 Syntax 2 Parameters 3 Return Value 4 Remarks

Syntax

plugin_send(MYGUID,"audioOutputStart",audio_t *);

Note that all Trillian functions and notifications begin with a lower-case letter, despite the Wiki requirement that all pages start with a capital letter.

Parameters

AudioOutputStart utilitizes the audio_t structure.

struct audio_t 
{ 
    unsigned int                struct_size; 

    int                         connection_id;
    int                         window_id;

    char                        *medium;
    char                        *name;
    char                        *location;

    char                        *section;

    int                         initiated;
    int                         ask_confirmation;

    /* Audio Information
     */

    int                         codec; 

    int                         audio_sample_size;
    int                         audio_sample_rate;
    int                         audio_block_size;
    int                         audio_quality;

    int                         audio_data_length; 

    unsigned char               *audio_data; 

    ttkCallback                 callback; 
    void                        *data; 
};

window_id

The ID of the window for which the audio stream is being started.

Return Value

This function returns 0 on success, or a negative value if an error occurs.

Remarks

When done with the stream, remember to use audioOutputStop to ensure it is no longer being used, and then audioOutputUninitialize.