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);
}