EVOLUTION-MANAGER
Edit File: oggz__io_8h.html
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> <meta http-equiv="X-UA-Compatible" content="IE=9"/> <meta name="generator" content="Doxygen 1.8.5"/> <title>liboggz: oggz_io.h File Reference</title> <link href="tabs.css" rel="stylesheet" type="text/css"/> <script type="text/javascript" src="jquery.js"></script> <script type="text/javascript" src="dynsections.js"></script> <link href="doxygen.css" rel="stylesheet" type="text/css" /> </head> <body> <div id="top"><!-- do not remove this div, it is closed by doxygen! --> <div id="titlearea"> <table cellspacing="0" cellpadding="0"> <tbody> <tr style="height: 56px;"> <td style="padding-left: 0.5em;"> <div id="projectname">liboggz  <span id="projectnumber">1.1.1</span> </div> </td> </tr> </tbody> </table> </div> <!-- end header part --> <!-- Generated by Doxygen 1.8.5 --> <div id="navrow1" class="tabs"> <ul class="tablist"> <li><a href="index.html"><span>Main Page</span></a></li> <li><a href="modules.html"><span>Modules</span></a></li> <li><a href="annotated.html"><span>Data Structures</span></a></li> <li class="current"><a href="files.html"><span>Files</span></a></li> </ul> </div> <div id="navrow2" class="tabs2"> <ul class="tablist"> <li><a href="files.html"><span>File List</span></a></li> <li><a href="globals.html"><span>Globals</span></a></li> </ul> </div> <div id="nav-path" class="navpath"> <ul> <li class="navelem"><a class="el" href="dir_d44c64559bbebec7f509842c48db8b23.html">include</a></li><li class="navelem"><a class="el" href="dir_d87111fb9e25a5f2a11bf853c53bb708.html">oggz</a></li> </ul> </div> </div><!-- top --> <div class="header"> <div class="summary"> <a href="#typedef-members">Typedefs</a> | <a href="#func-members">Functions</a> </div> <div class="headertitle"> <div class="title">oggz_io.h File Reference</div> </div> </div><!--header--> <div class="contents"> <p>Overriding the functions used for input and output of raw data. <a href="#details">More...</a></p> <p><a href="oggz__io_8h_source.html">Go to the source code of this file.</a></p> <table class="memberdecls"> <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="typedef-members"></a> Typedefs</h2></td></tr> <tr class="memitem:ae4995dabd7027c5a2273fe6db94c4733"><td class="memItemLeft" align="right" valign="top">typedef size_t(* </td><td class="memItemRight" valign="bottom"><a class="el" href="oggz__io_8h.html#ae4995dabd7027c5a2273fe6db94c4733">OggzIORead</a> )(void *user_handle, void *buf, size_t n)</td></tr> <tr class="memdesc:ae4995dabd7027c5a2273fe6db94c4733"><td class="mdescLeft"> </td><td class="mdescRight">This is the signature of a function which you provide for Oggz to call when it needs to acquire raw input data. <a href="#ae4995dabd7027c5a2273fe6db94c4733">More...</a><br/></td></tr> <tr class="separator:ae4995dabd7027c5a2273fe6db94c4733"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a0274a389b81ba93dae32d3d2fe39637f"><td class="memItemLeft" align="right" valign="top">typedef size_t(* </td><td class="memItemRight" valign="bottom"><a class="el" href="oggz__io_8h.html#a0274a389b81ba93dae32d3d2fe39637f">OggzIOWrite</a> )(void *user_handle, void *buf, size_t n)</td></tr> <tr class="memdesc:a0274a389b81ba93dae32d3d2fe39637f"><td class="mdescLeft"> </td><td class="mdescRight">This is the signature of a function which you provide for Oggz to call when it needs to output raw data. <a href="#a0274a389b81ba93dae32d3d2fe39637f">More...</a><br/></td></tr> <tr class="separator:a0274a389b81ba93dae32d3d2fe39637f"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ab92c1e4e1bc98165cb7e9a0920a09b75"><td class="memItemLeft" align="right" valign="top">typedef int(* </td><td class="memItemRight" valign="bottom"><a class="el" href="oggz__io_8h.html#ab92c1e4e1bc98165cb7e9a0920a09b75">OggzIOSeek</a> )(void *user_handle, long offset, int whence)</td></tr> <tr class="memdesc:ab92c1e4e1bc98165cb7e9a0920a09b75"><td class="mdescLeft"> </td><td class="mdescRight">This is the signature of a function which you provide for Oggz to call when it needs to seek on the raw input or output data. <a href="#ab92c1e4e1bc98165cb7e9a0920a09b75">More...</a><br/></td></tr> <tr class="separator:ab92c1e4e1bc98165cb7e9a0920a09b75"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:adac7e4773781ad067f0591e1699fd669"><td class="memItemLeft" align="right" valign="top">typedef long(* </td><td class="memItemRight" valign="bottom"><a class="el" href="oggz__io_8h.html#adac7e4773781ad067f0591e1699fd669">OggzIOTell</a> )(void *user_handle)</td></tr> <tr class="memdesc:adac7e4773781ad067f0591e1699fd669"><td class="mdescLeft"> </td><td class="mdescRight">This is the signature of a function which you provide for Oggz to call when it needs to determine the current offset of the raw input or output data. <a href="#adac7e4773781ad067f0591e1699fd669">More...</a><br/></td></tr> <tr class="separator:adac7e4773781ad067f0591e1699fd669"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a2d41d748db3b60bb25f716bcebf2f1e3"><td class="memItemLeft" align="right" valign="top">typedef int(* </td><td class="memItemRight" valign="bottom"><a class="el" href="oggz__io_8h.html#a2d41d748db3b60bb25f716bcebf2f1e3">OggzIOFlush</a> )(void *user_handle)</td></tr> <tr class="memdesc:a2d41d748db3b60bb25f716bcebf2f1e3"><td class="mdescLeft"> </td><td class="mdescRight">This is the signature of a function which you provide for Oggz to call when it needs to flush the output data. <a href="#a2d41d748db3b60bb25f716bcebf2f1e3">More...</a><br/></td></tr> <tr class="separator:a2d41d748db3b60bb25f716bcebf2f1e3"><td class="memSeparator" colspan="2"> </td></tr> </table><table class="memberdecls"> <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a> Functions</h2></td></tr> <tr class="memitem:a640ecb60fcee9323f1f735ad23f7abc4"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="oggz__io_8h.html#a640ecb60fcee9323f1f735ad23f7abc4">oggz_io_set_read</a> (<a class="el" href="oggz_8h.html#a672d218df13da45a4b41d5366211bfee">OGGZ</a> *oggz, <a class="el" href="oggz__io_8h.html#ae4995dabd7027c5a2273fe6db94c4733">OggzIORead</a> read, void *user_handle)</td></tr> <tr class="memdesc:a640ecb60fcee9323f1f735ad23f7abc4"><td class="mdescLeft"> </td><td class="mdescRight">Set a function for Oggz to call when it needs to read input data. <a href="#a640ecb60fcee9323f1f735ad23f7abc4">More...</a><br/></td></tr> <tr class="separator:a640ecb60fcee9323f1f735ad23f7abc4"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:af5bbd37e9a390e3c282fdc8bfadc43f6"><td class="memItemLeft" align="right" valign="top">void * </td><td class="memItemRight" valign="bottom"><a class="el" href="oggz__io_8h.html#af5bbd37e9a390e3c282fdc8bfadc43f6">oggz_io_get_read_user_handle</a> (<a class="el" href="oggz_8h.html#a672d218df13da45a4b41d5366211bfee">OGGZ</a> *oggz)</td></tr> <tr class="memdesc:af5bbd37e9a390e3c282fdc8bfadc43f6"><td class="mdescLeft"> </td><td class="mdescRight">Retrieve the user_handle associated with the function you have provided for reading input data. <a href="#af5bbd37e9a390e3c282fdc8bfadc43f6">More...</a><br/></td></tr> <tr class="separator:af5bbd37e9a390e3c282fdc8bfadc43f6"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:af92f5b20bb5f247b5302dfc8b4edfbee"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="oggz__io_8h.html#af92f5b20bb5f247b5302dfc8b4edfbee">oggz_io_set_write</a> (<a class="el" href="oggz_8h.html#a672d218df13da45a4b41d5366211bfee">OGGZ</a> *oggz, <a class="el" href="oggz__io_8h.html#a0274a389b81ba93dae32d3d2fe39637f">OggzIOWrite</a> write, void *user_handle)</td></tr> <tr class="memdesc:af92f5b20bb5f247b5302dfc8b4edfbee"><td class="mdescLeft"> </td><td class="mdescRight">Set a function for Oggz to call when it needs to write output data. <a href="#af92f5b20bb5f247b5302dfc8b4edfbee">More...</a><br/></td></tr> <tr class="separator:af92f5b20bb5f247b5302dfc8b4edfbee"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a024a62f080f1b64c465b0bf475ebfd2e"><td class="memItemLeft" align="right" valign="top">void * </td><td class="memItemRight" valign="bottom"><a class="el" href="oggz__io_8h.html#a024a62f080f1b64c465b0bf475ebfd2e">oggz_io_get_write_user_handle</a> (<a class="el" href="oggz_8h.html#a672d218df13da45a4b41d5366211bfee">OGGZ</a> *oggz)</td></tr> <tr class="memdesc:a024a62f080f1b64c465b0bf475ebfd2e"><td class="mdescLeft"> </td><td class="mdescRight">Retrieve the user_handle associated with the function you have provided for writing output data. <a href="#a024a62f080f1b64c465b0bf475ebfd2e">More...</a><br/></td></tr> <tr class="separator:a024a62f080f1b64c465b0bf475ebfd2e"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a8482fb0783df2621e811c14d642b01fc"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="oggz__io_8h.html#a8482fb0783df2621e811c14d642b01fc">oggz_io_set_seek</a> (<a class="el" href="oggz_8h.html#a672d218df13da45a4b41d5366211bfee">OGGZ</a> *oggz, <a class="el" href="oggz__io_8h.html#ab92c1e4e1bc98165cb7e9a0920a09b75">OggzIOSeek</a> seek, void *user_handle)</td></tr> <tr class="memdesc:a8482fb0783df2621e811c14d642b01fc"><td class="mdescLeft"> </td><td class="mdescRight">Set a function for Oggz to call when it needs to seek on its raw data. <a href="#a8482fb0783df2621e811c14d642b01fc">More...</a><br/></td></tr> <tr class="separator:a8482fb0783df2621e811c14d642b01fc"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a718ea817110f0d94d9d6f3a457707a08"><td class="memItemLeft" align="right" valign="top">void * </td><td class="memItemRight" valign="bottom"><a class="el" href="oggz__io_8h.html#a718ea817110f0d94d9d6f3a457707a08">oggz_io_get_seek_user_handle</a> (<a class="el" href="oggz_8h.html#a672d218df13da45a4b41d5366211bfee">OGGZ</a> *oggz)</td></tr> <tr class="memdesc:a718ea817110f0d94d9d6f3a457707a08"><td class="mdescLeft"> </td><td class="mdescRight">Retrieve the user_handle associated with the function you have provided for seeking on input or output data. <a href="#a718ea817110f0d94d9d6f3a457707a08">More...</a><br/></td></tr> <tr class="separator:a718ea817110f0d94d9d6f3a457707a08"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ad97da84267d72ab9abf8dbb9ff5e8931"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="oggz__io_8h.html#ad97da84267d72ab9abf8dbb9ff5e8931">oggz_io_set_tell</a> (<a class="el" href="oggz_8h.html#a672d218df13da45a4b41d5366211bfee">OGGZ</a> *oggz, <a class="el" href="oggz__io_8h.html#adac7e4773781ad067f0591e1699fd669">OggzIOTell</a> tell, void *user_handle)</td></tr> <tr class="memdesc:ad97da84267d72ab9abf8dbb9ff5e8931"><td class="mdescLeft"> </td><td class="mdescRight">Set a function for Oggz to call when it needs to determine the offset within its input data (if OGGZ_READ) or output data (if OGGZ_WRITE). <a href="#ad97da84267d72ab9abf8dbb9ff5e8931">More...</a><br/></td></tr> <tr class="separator:ad97da84267d72ab9abf8dbb9ff5e8931"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a54b69e5159280c1224025df925e67b50"><td class="memItemLeft" align="right" valign="top">void * </td><td class="memItemRight" valign="bottom"><a class="el" href="oggz__io_8h.html#a54b69e5159280c1224025df925e67b50">oggz_io_get_tell_user_handle</a> (<a class="el" href="oggz_8h.html#a672d218df13da45a4b41d5366211bfee">OGGZ</a> *oggz)</td></tr> <tr class="memdesc:a54b69e5159280c1224025df925e67b50"><td class="mdescLeft"> </td><td class="mdescRight">Retrieve the user_handle associated with the function you have provided for determining the current offset in input or output data. <a href="#a54b69e5159280c1224025df925e67b50">More...</a><br/></td></tr> <tr class="separator:a54b69e5159280c1224025df925e67b50"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:af45a2d33c7e17d1b64f794b32d69e7da"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="oggz__io_8h.html#af45a2d33c7e17d1b64f794b32d69e7da">oggz_io_set_flush</a> (<a class="el" href="oggz_8h.html#a672d218df13da45a4b41d5366211bfee">OGGZ</a> *oggz, <a class="el" href="oggz__io_8h.html#a2d41d748db3b60bb25f716bcebf2f1e3">OggzIOFlush</a> flush, void *user_handle)</td></tr> <tr class="memdesc:af45a2d33c7e17d1b64f794b32d69e7da"><td class="mdescLeft"> </td><td class="mdescRight">Set a function for Oggz to call when it needs to flush its output. <a href="#af45a2d33c7e17d1b64f794b32d69e7da">More...</a><br/></td></tr> <tr class="separator:af45a2d33c7e17d1b64f794b32d69e7da"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a6150bee0cc28c68553bdcc6d020f6932"><td class="memItemLeft" align="right" valign="top">void * </td><td class="memItemRight" valign="bottom"><a class="el" href="oggz__io_8h.html#a6150bee0cc28c68553bdcc6d020f6932">oggz_io_get_flush_user_handle</a> (<a class="el" href="oggz_8h.html#a672d218df13da45a4b41d5366211bfee">OGGZ</a> *oggz)</td></tr> <tr class="memdesc:a6150bee0cc28c68553bdcc6d020f6932"><td class="mdescLeft"> </td><td class="mdescRight">Retrieve the user_handle associated with the function you have provided for flushing output. <a href="#a6150bee0cc28c68553bdcc6d020f6932">More...</a><br/></td></tr> <tr class="separator:a6150bee0cc28c68553bdcc6d020f6932"><td class="memSeparator" colspan="2"> </td></tr> </table> <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2> <div class="textblock"><p>Overriding the functions used for input and output of raw data. </p> <p>OggzIO provides a way of overriding the functions Oggz uses to access its raw input or output data. This is required in many situations where the raw stream cannot be accessed via stdio, but can be accessed by other means. This is typically useful within media frameworks, where accessing and moving around in the data is possible only using methods provided by the framework.</p> <p>The functions you provide for overriding IO will be used by Oggz whenever you call <a class="el" href="group__read__api.html#ga3ce7a31de5da56375057436c6b5108f2" title="Read n bytes into oggz, calling any read callbacks on the fly. ">oggz_read()</a> or <a class="el" href="group__write__api.html#ga3c97d94ea425d64546adf9c368b71904" title="Write n bytes from an OGGZ handle. ">oggz_write()</a>. They will also be used repeatedly by Oggz when you call <a class="el" href="group__seek__api.html#gaeef4b261d443701207954e5a636d6817" title="Seek to a specific byte offset. ">oggz_seek()</a>.</p> <dl class="section note"><dt>Note</dt><dd>Opening a file with <a class="el" href="oggz_8h.html#a65197cdd03f755f7ebfabf2fdff4c7db" title="Open an Ogg file, creating an OGGZ handle for it. ">oggz_open()</a> or <a class="el" href="oggz_8h.html#ac49e9de0bc4ef1d91b43b13605f98b19" title="Create an OGGZ handle associated with a stdio stream. ">oggz_open_stdio()</a> is equivalent to calling <a class="el" href="oggz_8h.html#a6eb34d123389ae38d993601f9e7bb9d6" title="Create a new OGGZ object. ">oggz_new()</a> and setting stdio based functions for data IO. </dd></dl> </div><h2 class="groupheader">Typedef Documentation</h2> <a class="anchor" id="a2d41d748db3b60bb25f716bcebf2f1e3"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">typedef int(* OggzIOFlush)(void *user_handle)</td> </tr> </table> </div><div class="memdoc"> <p>This is the signature of a function which you provide for Oggz to call when it needs to flush the output data. </p> <p>The behaviour of this function is similar to that of fflush() in stdio.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">user_handle</td><td>A generic pointer you have provided earlier </td></tr> </table> </dd> </dl> <dl class="retval"><dt>Return values</dt><dd> <table class="retval"> <tr><td class="paramname">0</td><td>Success </td></tr> <tr><td class="paramname">< 0</td><td>An error condition </td></tr> </table> </dd> </dl> </div> </div> <a class="anchor" id="ae4995dabd7027c5a2273fe6db94c4733"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">typedef size_t(* OggzIORead)(void *user_handle, void *buf, size_t n)</td> </tr> </table> </div><div class="memdoc"> <p>This is the signature of a function which you provide for Oggz to call when it needs to acquire raw input data. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">user_handle</td><td>A generic pointer you have provided earlier </td></tr> <tr><td class="paramname">n</td><td>The length in bytes that Oggz wants to read </td></tr> <tr><td class="paramname">buf</td><td>The buffer that you read data into </td></tr> </table> </dd> </dl> <dl class="retval"><dt>Return values</dt><dd> <table class="retval"> <tr><td class="paramname">> 0</td><td>The number of bytes successfully read into the buffer </td></tr> <tr><td class="paramname">0</td><td>to indicate that there is no more data to read (End of file) </td></tr> <tr><td class="paramname">< 0</td><td>An error condition </td></tr> </table> </dd> </dl> </div> </div> <a class="anchor" id="ab92c1e4e1bc98165cb7e9a0920a09b75"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">typedef int(* OggzIOSeek)(void *user_handle, long offset, int whence)</td> </tr> </table> </div><div class="memdoc"> <p>This is the signature of a function which you provide for Oggz to call when it needs to seek on the raw input or output data. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">user_handle</td><td>A generic pointer you have provided earlier </td></tr> <tr><td class="paramname">offset</td><td>The offset in bytes to seek to </td></tr> <tr><td class="paramname">whence</td><td>SEEK_SET, SEEK_CUR or SEEK_END (as for stdio.h) </td></tr> </table> </dd> </dl> <dl class="retval"><dt>Return values</dt><dd> <table class="retval"> <tr><td class="paramname">>= 0</td><td>The offset seeked to </td></tr> <tr><td class="paramname">< 0</td><td>An error condition</td></tr> </table> </dd> </dl> <dl class="section note"><dt>Note</dt><dd>If you provide an OggzIOSeek function, you MUST also provide an OggzIOTell function, or else all your seeks will fail. </dd></dl> </div> </div> <a class="anchor" id="adac7e4773781ad067f0591e1699fd669"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">typedef long(* OggzIOTell)(void *user_handle)</td> </tr> </table> </div><div class="memdoc"> <p>This is the signature of a function which you provide for Oggz to call when it needs to determine the current offset of the raw input or output data. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">user_handle</td><td>A generic pointer you have provided earlier </td></tr> </table> </dd> </dl> <dl class="retval"><dt>Return values</dt><dd> <table class="retval"> <tr><td class="paramname">>= 0</td><td>The offset </td></tr> <tr><td class="paramname">< 0</td><td>An error condition </td></tr> </table> </dd> </dl> </div> </div> <a class="anchor" id="a0274a389b81ba93dae32d3d2fe39637f"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">typedef size_t(* OggzIOWrite)(void *user_handle, void *buf, size_t n)</td> </tr> </table> </div><div class="memdoc"> <p>This is the signature of a function which you provide for Oggz to call when it needs to output raw data. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">user_handle</td><td>A generic pointer you have provided earlier </td></tr> <tr><td class="paramname">n</td><td>The length in bytes of the data </td></tr> <tr><td class="paramname">buf</td><td>A buffer containing data to write </td></tr> </table> </dd> </dl> <dl class="retval"><dt>Return values</dt><dd> <table class="retval"> <tr><td class="paramname">>= 0</td><td>The number of bytes successfully written (may be less than <em>n</em> if a write error has occurred) </td></tr> <tr><td class="paramname">< 0</td><td>An error condition </td></tr> </table> </dd> </dl> </div> </div> <h2 class="groupheader">Function Documentation</h2> <a class="anchor" id="a6150bee0cc28c68553bdcc6d020f6932"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void* oggz_io_get_flush_user_handle </td> <td>(</td> <td class="paramtype"><a class="el" href="oggz_8h.html#a672d218df13da45a4b41d5366211bfee">OGGZ</a> * </td> <td class="paramname"><em>oggz</em></td><td>)</td> <td></td> </tr> </table> </div><div class="memdoc"> <p>Retrieve the user_handle associated with the function you have provided for flushing output. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">oggz</td><td>An OGGZ handle </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>the associated user_handle </dd></dl> </div> </div> <a class="anchor" id="af5bbd37e9a390e3c282fdc8bfadc43f6"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void* oggz_io_get_read_user_handle </td> <td>(</td> <td class="paramtype"><a class="el" href="oggz_8h.html#a672d218df13da45a4b41d5366211bfee">OGGZ</a> * </td> <td class="paramname"><em>oggz</em></td><td>)</td> <td></td> </tr> </table> </div><div class="memdoc"> <p>Retrieve the user_handle associated with the function you have provided for reading input data. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">oggz</td><td>An OGGZ handle </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>the associated user_handle </dd></dl> </div> </div> <a class="anchor" id="a718ea817110f0d94d9d6f3a457707a08"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void* oggz_io_get_seek_user_handle </td> <td>(</td> <td class="paramtype"><a class="el" href="oggz_8h.html#a672d218df13da45a4b41d5366211bfee">OGGZ</a> * </td> <td class="paramname"><em>oggz</em></td><td>)</td> <td></td> </tr> </table> </div><div class="memdoc"> <p>Retrieve the user_handle associated with the function you have provided for seeking on input or output data. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">oggz</td><td>An OGGZ handle </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>the associated user_handle </dd></dl> </div> </div> <a class="anchor" id="a54b69e5159280c1224025df925e67b50"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void* oggz_io_get_tell_user_handle </td> <td>(</td> <td class="paramtype"><a class="el" href="oggz_8h.html#a672d218df13da45a4b41d5366211bfee">OGGZ</a> * </td> <td class="paramname"><em>oggz</em></td><td>)</td> <td></td> </tr> </table> </div><div class="memdoc"> <p>Retrieve the user_handle associated with the function you have provided for determining the current offset in input or output data. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">oggz</td><td>An OGGZ handle </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>the associated user_handle </dd></dl> </div> </div> <a class="anchor" id="a024a62f080f1b64c465b0bf475ebfd2e"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void* oggz_io_get_write_user_handle </td> <td>(</td> <td class="paramtype"><a class="el" href="oggz_8h.html#a672d218df13da45a4b41d5366211bfee">OGGZ</a> * </td> <td class="paramname"><em>oggz</em></td><td>)</td> <td></td> </tr> </table> </div><div class="memdoc"> <p>Retrieve the user_handle associated with the function you have provided for writing output data. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">oggz</td><td>An OGGZ handle </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>the associated user_handle </dd></dl> </div> </div> <a class="anchor" id="af45a2d33c7e17d1b64f794b32d69e7da"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">int oggz_io_set_flush </td> <td>(</td> <td class="paramtype"><a class="el" href="oggz_8h.html#a672d218df13da45a4b41d5366211bfee">OGGZ</a> * </td> <td class="paramname"><em>oggz</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype"><a class="el" href="oggz__io_8h.html#a2d41d748db3b60bb25f716bcebf2f1e3">OggzIOFlush</a> </td> <td class="paramname"><em>flush</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">void * </td> <td class="paramname"><em>user_handle</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> <p>Set a function for Oggz to call when it needs to flush its output. </p> <p>The meaning of this is similar to that of fflush() in stdio.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">oggz</td><td>An OGGZ handle </td></tr> <tr><td class="paramname">flush</td><td>Your flushing function </td></tr> <tr><td class="paramname">user_handle</td><td>Any arbitrary data you wish to pass to the function </td></tr> </table> </dd> </dl> <dl class="retval"><dt>Return values</dt><dd> <table class="retval"> <tr><td class="paramname">0</td><td>Success </td></tr> <tr><td class="paramname">OGGZ_ERR_BAD_OGGZ</td><td><em>oggz</em> does not refer to an existing OGGZ </td></tr> <tr><td class="paramname">OGGZ_ERR_INVALID</td><td>Operation not suitable for this OGGZ; <em>oggz</em> not open for writing. </td></tr> <tr><td class="paramname">OGGZ_ERR_OUT_OF_MEMORY</td><td>Out of memory </td></tr> </table> </dd> </dl> </div> </div> <a class="anchor" id="a640ecb60fcee9323f1f735ad23f7abc4"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">int oggz_io_set_read </td> <td>(</td> <td class="paramtype"><a class="el" href="oggz_8h.html#a672d218df13da45a4b41d5366211bfee">OGGZ</a> * </td> <td class="paramname"><em>oggz</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype"><a class="el" href="oggz__io_8h.html#ae4995dabd7027c5a2273fe6db94c4733">OggzIORead</a> </td> <td class="paramname"><em>read</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">void * </td> <td class="paramname"><em>user_handle</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> <p>Set a function for Oggz to call when it needs to read input data. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">oggz</td><td>An OGGZ handle </td></tr> <tr><td class="paramname">read</td><td>Your reading function </td></tr> <tr><td class="paramname">user_handle</td><td>Any arbitrary data you wish to pass to the function </td></tr> </table> </dd> </dl> <dl class="retval"><dt>Return values</dt><dd> <table class="retval"> <tr><td class="paramname">0</td><td>Success </td></tr> <tr><td class="paramname">OGGZ_ERR_BAD_OGGZ</td><td><em>oggz</em> does not refer to an existing OGGZ </td></tr> <tr><td class="paramname">OGGZ_ERR_INVALID</td><td>Operation not suitable for this OGGZ; <em>oggz</em> not open for reading. </td></tr> <tr><td class="paramname">OGGZ_ERR_OUT_OF_MEMORY</td><td>Out of memory </td></tr> </table> </dd> </dl> </div> </div> <a class="anchor" id="a8482fb0783df2621e811c14d642b01fc"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">int oggz_io_set_seek </td> <td>(</td> <td class="paramtype"><a class="el" href="oggz_8h.html#a672d218df13da45a4b41d5366211bfee">OGGZ</a> * </td> <td class="paramname"><em>oggz</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype"><a class="el" href="oggz__io_8h.html#ab92c1e4e1bc98165cb7e9a0920a09b75">OggzIOSeek</a> </td> <td class="paramname"><em>seek</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">void * </td> <td class="paramname"><em>user_handle</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> <p>Set a function for Oggz to call when it needs to seek on its raw data. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">oggz</td><td>An OGGZ handle </td></tr> <tr><td class="paramname">seek</td><td>Your seeking function </td></tr> <tr><td class="paramname">user_handle</td><td>Any arbitrary data you wish to pass to the function </td></tr> </table> </dd> </dl> <dl class="retval"><dt>Return values</dt><dd> <table class="retval"> <tr><td class="paramname">0</td><td>Success </td></tr> <tr><td class="paramname">OGGZ_ERR_BAD_OGGZ</td><td><em>oggz</em> does not refer to an existing OGGZ </td></tr> <tr><td class="paramname">OGGZ_ERR_INVALID</td><td>Operation not suitable for this OGGZ </td></tr> <tr><td class="paramname">OGGZ_ERR_OUT_OF_MEMORY</td><td>Out of memory</td></tr> </table> </dd> </dl> <dl class="section note"><dt>Note</dt><dd>If you provide an OggzIOSeek function, you MUST also provide an OggzIOTell function, or else all your seeks will fail. </dd></dl> </div> </div> <a class="anchor" id="ad97da84267d72ab9abf8dbb9ff5e8931"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">int oggz_io_set_tell </td> <td>(</td> <td class="paramtype"><a class="el" href="oggz_8h.html#a672d218df13da45a4b41d5366211bfee">OGGZ</a> * </td> <td class="paramname"><em>oggz</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype"><a class="el" href="oggz__io_8h.html#adac7e4773781ad067f0591e1699fd669">OggzIOTell</a> </td> <td class="paramname"><em>tell</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">void * </td> <td class="paramname"><em>user_handle</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> <p>Set a function for Oggz to call when it needs to determine the offset within its input data (if OGGZ_READ) or output data (if OGGZ_WRITE). </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">oggz</td><td>An OGGZ handle </td></tr> <tr><td class="paramname">tell</td><td>Your tell function </td></tr> <tr><td class="paramname">user_handle</td><td>Any arbitrary data you wish to pass to the function </td></tr> </table> </dd> </dl> <dl class="retval"><dt>Return values</dt><dd> <table class="retval"> <tr><td class="paramname">0</td><td>Success </td></tr> <tr><td class="paramname">OGGZ_ERR_BAD_OGGZ</td><td><em>oggz</em> does not refer to an existing OGGZ </td></tr> <tr><td class="paramname">OGGZ_ERR_INVALID</td><td>Operation not suitable for this OGGZ </td></tr> <tr><td class="paramname">OGGZ_ERR_OUT_OF_MEMORY</td><td>Out of memory </td></tr> </table> </dd> </dl> </div> </div> <a class="anchor" id="af92f5b20bb5f247b5302dfc8b4edfbee"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">int oggz_io_set_write </td> <td>(</td> <td class="paramtype"><a class="el" href="oggz_8h.html#a672d218df13da45a4b41d5366211bfee">OGGZ</a> * </td> <td class="paramname"><em>oggz</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype"><a class="el" href="oggz__io_8h.html#a0274a389b81ba93dae32d3d2fe39637f">OggzIOWrite</a> </td> <td class="paramname"><em>write</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">void * </td> <td class="paramname"><em>user_handle</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> <p>Set a function for Oggz to call when it needs to write output data. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">oggz</td><td>An OGGZ handle </td></tr> <tr><td class="paramname">write</td><td>Your writing function </td></tr> <tr><td class="paramname">user_handle</td><td>Any arbitrary data you wish to pass to the function </td></tr> </table> </dd> </dl> <dl class="retval"><dt>Return values</dt><dd> <table class="retval"> <tr><td class="paramname">0</td><td>Success </td></tr> <tr><td class="paramname">OGGZ_ERR_BAD_OGGZ</td><td><em>oggz</em> does not refer to an existing OGGZ </td></tr> <tr><td class="paramname">OGGZ_ERR_INVALID</td><td>Operation not suitable for this OGGZ; <em>oggz</em> not open for writing. </td></tr> <tr><td class="paramname">OGGZ_ERR_OUT_OF_MEMORY</td><td>Out of memory </td></tr> </table> </dd> </dl> </div> </div> </div><!-- contents --> <!-- start footer part --> <hr class="footer"/><address class="footer"><small> Generated by  <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/> </a> 1.8.5 </small></address> </body> </html>