man YSHMCloseSound (Fonctions bibliothèques) - shared sound buffer closing

NAME

YSHMCloseSound - shared sound buffer closing

SYNTAX

#include <Y2/Y.h>

#include <Y2/Ylib.h>

void YSHMCloseSound(

YConnection *connection,

void *ptr

)

ARGUMENTS

connection
Specifies the connection to the Y server, obtained by a call to YOpenConnection.
ptr
Specifies the pointer to the sound buffer on the Y server that was obtained by a call to YSHMOpenSound.

DESCRIPTION

The YSHMCloseSound closes a direct pointer to the sound buffer on the Y server. The pointer ptr must have been obtained by a prior call to YSHMOpenSound.

If you receive a YSHMSound event with the minor_op_code set to YSHMSoundClose then the pointer to the sound buffer obtained from YSHMOpenSound is no longer referenced by the Y server and is now useless. You need to reopen the buffer by calling YSHMCloseSound and then YSHMOpenSound to reobtain the direct pointer to the sound buffer on the Y server.

The process of the client and the server must both be running on the same physical machine.

EXAMPLE

#include <stdio.h>

#include <Y2/Y.h>

#include <Y2/Ylib.h>

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

{

int length, id;

void *buf;

YConnection *con = YOpenConnection(

"/usr/sbin/starty",

"127.0.0.1:9433"

);

if(con == NULL)

return(1);

/* Obtain the pointer to the sound buffer. */

buf = YSHMOpenSound(con, &length, &id);

if(buf != NULL)

{

/* Do something with the buffer here. */

/* Close the pointer to the sound buffer. */

YSHMCloseSound(con, buf);

}

YCloseConnection(con, False);

return(0);

}

SEE ALSO