haiku-website/static/legacy-docs/bebook/BSmallBuffer_Overview.html

22 lines
5.8 KiB
HTML
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>The Be Book - System Overview - The Media Kit</title><link rel="stylesheet" href="be_book.css" type="text/css" media="all" /><link rel="shortcut icon" type="image/vnd.microsoft.icon" href="./images/favicon.ico" /><!--[if IE]>
<link rel="stylesheet" type="text/css" href="be_book_ie.css" />
<![endif]--><meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /><meta name="keywords" content="Access, BeOS, BeBook, API" /><link rel="start" href="index.html" title="The Be Book" /><link rel="up" href="TheMediaKit_Overview.html" title="The Media Kit" /><link rel="prev" href="BParameterWeb_Overview.html" title="BParameterWeb" /><link rel="next" href="BSoundPlayer_Overview.html" title="BSoundPlayer" /></head><body><div id="header"><div id="headerT"><div id="headerTL"><a accesskey="p" href="BParameterWeb_Overview.html" title="BParameterWeb"><img src="./images/navigation/prev.png" alt="Prev" /></a> <a accesskey="u" href="TheMediaKit_Overview.html" title="The Media Kit"><img src="./images/navigation/up.png" alt="Up" /></a> <a accesskey="n" href="BSoundPlayer_Overview.html" title="BSoundPlayer"><img src="./images/navigation/next.png" alt="Next" /></a></div><div id="headerTR"><div id="navigpeople"><a href="http://www.haiku-os.org"><img src="./images/People_24.png" alt="haiku-os.org" title="Visit The Haiku Website" /></a></div><div class="navighome" title="Home"><a accesskey="h" href="index.html"><img src="./images/navigation/home.png" alt="Home" /></a></div><div class="navigboxed" id="navigindex"><a accesskey="i" href="ClassIndex.html" title="Index">I</a></div><div class="navigboxed" id="naviglang" title="English">en</div></div><div id="headerTC">The Be Book - System Overview - The Media Kit</div></div><div id="headerB">Prev: <a href="BParameterWeb_Overview.html">BParameterWeb</a>  Up: <a href="TheMediaKit_Overview.html">The Media Kit</a>  Next: <a href="BSoundPlayer_Overview.html">BSoundPlayer</a></div><hr /></div><div class="section"><div xmlns="" xmlns:d="http://docbook.org/ns/docbook" class="titlepage"><div><div xmlns:d="http://docbook.org/ns/docbook"><h2 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="BSmallBuffer_Overview"></a>BSmallBuffer</h2></div></div></div><a id="id590964" class="indexterm"></a><p>The <a class="link" href="BSmallBuffer.html" title="BSmallBuffer"><code class="classname">BSmallBuffer</code></a>
class provides small, efficient buffers for MIDI and
other small packet-based media types.</p><p>To use <a class="link" href="BSmallBuffer.html" title="BSmallBuffer"><code class="classname">BSmallBuffer</code></a>s,
create a <a class="link" href="BSmallBuffer.html" title="BSmallBuffer"><code class="classname">BSmallBuffer</code></a>,
then fill it with up to
<a class="link" href="BSmallBuffer.html#BSmallBuffer_SmallBufferSizeLimit" title="BroadcastTimeWarp()"><code class="methodname">SmallBufferSizeLimit()</code></a>
bytes of data. Then call
<a class="link" href="BBufferProducer.html#BBufferProducer_SendBuffer" title="SendBuffer()"><code class="methodname">SendBuffer()</code></a>.
You can then immediately reuse the buffer.</p><p>How is this possible? <a class="link" href="BSmallBuffer.html" title="BSmallBuffer"><code class="classname">BSmallBuffer</code></a>s
don't go in buffer groups. The
receiver immediately either processes the buffer (if it's time) or caches
it until it's needed, then recycles the buffer.</p><div class="admonition note"><div class="title">Note</div><div class="graphic"><img class="icon" alt="Note" width="32" src="./images/admonitions/Info_32.png" /><div class="text"><p>If you're writing a node, and receive a buffer with the <code class="constant">B_SMALL_BUFFER</code>
flag set, you must recycle the buffer in your
<a class="link" href="BBufferConsumer.html#BBufferConsumer_BufferReceived" title="BufferReceived()"><code class="methodname">BufferReceived()</code></a>
function.</p></div></div></div></div><div id="footer"><hr /><div id="footerT">Prev: <a href="BParameterWeb_Overview.html">BParameterWeb</a>  Up: <a href="TheMediaKit_Overview.html">The Media Kit</a>  Next: <a href="BSoundPlayer_Overview.html">BSoundPlayer</a> </div><div id="footerB"><div id="footerBL"><a href="BParameterWeb_Overview.html" title="BParameterWeb"><img src="./images/navigation/prev.png" alt="Prev" /></a> <a href="TheMediaKit_Overview.html" title="The Media Kit"><img src="./images/navigation/up.png" alt="Up" /></a> <a href="BSoundPlayer_Overview.html" title="BSoundPlayer"><img src="./images/navigation/next.png" alt="Next" /></a></div><div id="footerBR"><div><a href="http://www.haiku-os.org"><img src="./images/People_24.png" alt="haiku-os.org" title="Visit The Haiku Website" /></a></div><div class="navighome" title="Home"><a accesskey="h" href="index.html"><img src="./images/navigation/home.png" alt="Home" /></a></div></div><div id="footerBC"><a href="http://www.access-company.com/home.html" title="ACCESS Co."><img alt="Access Company" src="./images/access_logo.png" /></a></div></div></div><div id="licenseFooter"><div id="licenseFooterBL"><a rel="license" href="http://creativecommons.org/licenses/by-nc-nd/3.0/" title="Creative Commons License"><img alt="Creative Commons License" style="border-width:0" src="https://licensebuttons.net/l/by-nc-nd/3.0/88x31.png" /></a></div><div id="licenseFooterBR"><a href="./LegalNotice.html">Legal Notice</a></div><div id="licenseFooterBC"><span id="licenseText">This work is licensed under a
<a rel="license" href="http://creativecommons.org/licenses/by-nc-nd/3.0/">Creative
Commons Attribution-Non commercial-No Derivative Works 3.0 License</a>.</span></div></div></body></html>