1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml">
3  <head>
4    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5    <meta http-equiv="Content-Style-Type" content="text/css" />
6    <link rel="stylesheet" href="../../../../css/manpage.css" type="text/css" />
7<title>Send</title>
8  </head>
9  <body>
10<h1><CODE>nn::rdt::CTR::Sender::Send</CODE> Member Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14<a href="../../../../nn/Result/Overview.html">nn::Result</a> Send(
15     const void * pBuf,
16     size_t bufSize
17);
18</pre>
19    </div>
20<h2>Arguments</h2>
21    <div class="section">
22      <table class="arguments">
23        <thead>
24          <tr>
25            <td width="15" />
26<th>Name</th>
27<td>Description</td>
28          </tr>
29        </thead>
30        <tr>
31<td>in</td>
32<th>pBuf</th>
33<td>Pointer to the start of the send data. This must not be a null pointer.</td>
34        </tr>
35        <tr>
36<td>in</td>
37<th>bufSize</th>
38<td>If the size of the send data (in bytes) is set to <CODE>0</CODE>, the function will do nothing and return a non-error value.</td>
39        </tr> </table>
40    </div>
41<h2>Return Values</h2>
42<div class="section">Returns a value indicating whether data was successfully written to the send buffer. Specifically, the following values may be returned: <CODE>ResultSuccess</CODE>, <CODE><a href="../../../../nn/rdt/CTR/ResultNotInitialized/Overview.html">ResultNotInitialized</a></CODE>, <CODE><a href="../../../../nn/rdt/CTR/ResultDoNothing/Overview.html">ResultDoNothing</a></CODE>, <CODE><a href="../../../../nn/rdt/CTR/ResultSendBufferIsNotAvailable/Overview.html"><CODE>ResultSendBufferIsNotAvailable</a></CODE>, and <a href="../../../../nn/rdt/CTR/ResultUntimelyFunctionCall/Overview.html">ResultUntimelyFunctionCall</a></CODE>. </div>
43<h2>Description</h2>
44    <div class="section">
45<p>Writes data to the send buffer.</p><p>If you can verify that the call succeeded, then the data has been copied to the send buffer and it will cause no problems to destroy the region pointed to by <SPAN class="argument">pBuf</SPAN>. If the send buffer has insufficient space and it is not possible to write the requested amount of data, this function call fails. In this case, no data at all is written to the send buffer. If <a href="../../../../nn/rdt/CTR/Sender/Send.html"><CODE>Send</CODE></a> fails, wait a short while and then try again. Data written to the send buffer is actually sent within the <a href="../../../../nn/rdt/CTR/Sender/Process.html"><CODE>Process</CODE></a> function.</p><!-- write here --></div>
46<h2>Revision History</h2>
47    <div class="section">
48      <dl class="history">
49        <dt>2010/06/14</dt>
50<dd>Initial version.<br />
51        </dd>
52      </dl>
53    </div>
54  <hr><p>CONFIDENTIAL</p></body>
55</html>