Poster of Linux kernelThe best gift for a Linux geek
YSHMCloseSound

YSHMCloseSound

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

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

YSHMOpenSound(3) YEventYSHMSound(3)


 

Index

NAME
SYNTAX
ARGUMENTS
DESCRIPTION
EXAMPLE
SEE ALSO

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