VirtualBox

source: vbox/trunk/src/libs/libogg-1.3.5/doc/libogg/ogg_sync_buffer.html

Last change on this file was 96360, checked in by vboxsync, 3 years ago

libogg, libvorbis: export to OSE

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 2.0 KB
Line 
1<html>
2
3<head>
4<title>libogg - function - ogg_sync_buffer</title>
5<link rel=stylesheet href="style.css" type="text/css">
6</head>
7
8<body bgcolor=white text=black link="#5555ff" alink="#5555ff" vlink="#5555ff">
9<table border=0 width=100%>
10<tr>
11<td><p class=tiny>libogg documentation</p></td>
12<td align=right><p class=tiny>libogg release 1.3.5 - 20210603</p></td>
13</tr>
14</table>
15
16<h1>ogg_sync_buffer</h1>
17
18<p><i>declared in "ogg/ogg.h";</i></p>
19
20<p>This function is used to provide a properly-sized buffer for writing.
21<p>Buffer space which has already been returned is cleared, and the buffer is extended as necessary by the size plus some additional bytes. Within the current implementation, an extra 4096 bytes are allocated, but applications should not rely on this additional buffer space.
22<p>The buffer exposed by this function is empty internal storage from the <a href="ogg_sync_state.html">ogg_sync_state</a> struct, beginning at the fill mark within the struct.
23<p>A pointer to this buffer is returned to be used by the calling application.
24
25<br><br>
26<table border=0 color=black cellspacing=0 cellpadding=7>
27<tr bgcolor=#cccccc>
28 <td>
29<pre><b>
30char *ogg_sync_buffer(ogg_sync_state *oy, long size);
31</b></pre>
32 </td>
33</tr>
34</table>
35
36<h3>Parameters</h3>
37<dl>
38<dt><i>oy</i></dt>
39<dd>Pointer to a previously declared <a href="ogg_sync_state.html">ogg_sync_state</a> struct.</dd>
40<dt><i>size</i></dt>
41<dd>Size of the desired buffer. The actual size of the buffer returned will be this size plus some extra bytes (currently 4096).
42</dl>
43
44
45<h3>Return Values</h3>
46<blockquote>
47<li>
48Returns a pointer to the newly allocated buffer or NULL on error</li>
49</blockquote>
50<p>
51
52<br><br>
53<hr noshade>
54<table border=0 width=100%>
55<tr valign=top>
56<td><p class=tiny>copyright &copy; 2000-2021 Xiph.Org Foundation</p></td>
57<td align=right><p class=tiny><a href="http://www.xiph.org/ogg/">Ogg Container Format</a></p></td>
58</tr><tr>
59<td><p class=tiny>libogg documentation</p></td>
60<td align=right><p class=tiny>libogg release 1.3.5 - 20210603</p></td>
61</tr>
62</table>
63
64
65</body>
66
67</html>
Note: See TracBrowser for help on using the repository browser.

© 2025 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette