NAME
YGetSoundObjectAttributes - Sound object attributes
SYNTAX
#include <Y2/Y.h>
#include <Y2/Ylib.h>
int YGetSoundObjectAttributes(
YConnection *connection,
const char *path,
YEventSoundObjectAttributes *buf
)
ARGUMENTS
connection
Specifies the connection to the Y server, obtained by a call to
YOpenConnection.
path Specifies the path (in UNIX path notation) to the sound object
on the VFS (virtual file system) of the machine that the Y
server is running on. If the path is not absolute, then a set of
search paths defined on the Y server will be searched through.
buf Specifies the pointer to the buffer to put the sound object
attrbiutes in. See YEventSoundObjectAttributes for more
information about this structure.
DESCRIPTION
The YGetSoundObjectAttributes function fetches the attributes for the
sound object specified by path and stores the values in the buffer
pointer to by buf.
RETURN VALUE
The YGetSoundObjectAttributes function returns -1 if the sound object
does not exist/is not accessible or 0 on success.
EXAMPLE
#include <stdio.h>
#include <Y2/Y.h>
#include <Y2/Ylib.h>
int main(int argc, char *argv[])
{
YEventSoundObjectAttributes buf;
YConnection *con = YOpenConnection(
"/usr/sbin/starty",
"127.0.0.1:9433"
);
if(con == NULL)
return(1);
if(YGetSoundObjectAttributes(
con, "/usr/share/sounds/info.wav", &buf
))
printf("Failed.\n");
else
printf("Success.\n");
YCloseConnection(con, False);
return(0);
}
SEE ALSO
YStartPlaySoundObject(3) YDestroyPlaySoundObject(3)