NAME
YDestroyPlaySoundObject - sound object stopping
SYNTAX
#include <Y2/Y.h>
#include <Y2/Ylib.h>
void YDestroyPlaySoundObject(
YConnection *connection,
YID yid
)
ARGUMENTS
connection
Specifies the connection to the Y server, obtained by a call to
YOpenConnection.
yid Specifies the YID of the playing instance of the sound object
that you want to stop. This value should have been returned by a
prior call to YStartPlaySoundObject or
YStartPlaySoundObjectSimple.
DESCRIPTION
The YDestroyPlaySoundObject function stops the playing instance of a
sound object referanced by the specified yid.
The yid should have been obtained by a prior call to
YStartPlaySoundObject or YStartPlaySoundObjectSimple If yid is YIDNULL
or no longer existant then no operation will be performed.
A YSoundObjectKill event will be sent to the Y client if a sound object
currently being played was killed.
EXAMPLE
#include <stdio.h>
#include <unistd.h>
#include <Y2/Y.h>
#include <Y2/Ylib.h>
int main(int argc, char *argv[])
{
YID yid;
YConnection *con = YOpenConnection(
"/usr/sbin/starty",
"127.0.0.1:9433"
);
if(con == NULL)
return(1);
yid = YStartPlaySoundObjectSimple(
con, "/usr/share/sounds/info.wav"
);
sleep(3);
YDestroyPlaySoundObject(con, yid);
YCloseConnection(con, False);
return(0);
}
SEE ALSO
YStartPlaySoundObject(3) YStartPlaySoundObjectSimple(3)
YGetSoundObjectAttributes(3)