Poster of Linux kernelThe best gift for a Linux geek
YGetAudioCDTracks

YGetAudioCDTracks

Section: Y Version 2 (3) Updated: Release 14
Local index Up
 

NAME

YGetAudioCDTracks - Audio CD tracks list retrieving  

SYNTAX

#include <Y2/Y.h>
#include <Y2/Ylib.h>

YAudioCDTrackStruct **YGetAudioCDTracks(

        YConnection *connection,

        int *count
)  

ARGUMENTS

connection
Specifies the connection to the Y server, obtained by a call to YOpenConnection.
count
Specifies a pointer to an int that will indicate the number of dynamically allocated YAudioCDTrackStruct structures returned.
 

DESCRIPTION

The YGetAudioCDTracks function fetches a list of audio CD track values from the Y server. If no audio CD is present then NULL is returned.  

RETURN VALUE

The YGetAudioCDTracks function returns a pointer to an array of pointers of YAudioCDTrackStruct structures. The returned pointer needs to be deallocated by calling YFreeAudioCDTracksList.

Can return NULL on error.  

EXAMPLE

#include <stdio.h>
#include <Y2/Y.h>
#include <Y2/Ylib.h>

int main(int argc, char *argv[])
{

        YAudioCDTrackStruct **list;

        int count;

        YConnection *con = YOpenConnection(

                "/usr/sbin/starty",

                "127.0.0.1:9433"

        );

        if(con == NULL)

                return(1);


        list = YGetAudioCDTracks(con, &count);


        /* Iterate through list here. */


        YFreeAudioCDTracksList(list, count);


        YCloseConnection(con, False);


        return(0);
}  

SEE ALSO

YFreeAudioCDTracksList(3) YAudioCDTrackStruct(3) YPlayAudioCDTrack(3) YStopAudioCD(3) YEjectAudioCD(3)


 

Index

NAME
SYNTAX
ARGUMENTS
DESCRIPTION
RETURN VALUE
EXAMPLE
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 21:59:21 GMT, April 16, 2011