NNS_McsRegisterStreamRecvBuffer

Syntax

#include <nnsys/mcs.h>

void NNS_McsRegisterStreamRecvBuffer(
         u16     channel,
         void*   buf,
         u32     bufSize);

Arguments

`channel`	Value for identifying a stream. Specify in the range of 0 to `0x3FFF`. The range of `0x4000` to `0x7FFF` is reserved for TWL-System applications. The range of `0x8000` to `0xFFFF` is reserved for the MCS system.
`buf`	Receive buffer to register.
`bufSize`	Size of the receive buffer to register.

Return Values

None.

Description

Registers a buffer for receiving data. The NNS_McsRegisterRecvCallback function gets called internally, so this function cannot be used at the same time as the data receive callback. This function also internally allocates an information area inside the specified buffer for internal use. For this reason, the size of the buffer must be at least 48.

If the reception buffer becomes so full with received data that it does not have free space for newly-received data, this newly-received data gets discarded. For this reason, it is essential to set the buffer size large enough to handle the data volumes involved in communications.

Revision History

2008/06/20 Changed NITRO-System to TWL-System.
2004/10/08 Added a description of the channel argument. Added NNS_McsUnregisterRecvResource in See Also.
2004/08/26 Changed the type of the channel argument.
2004/06/01 Initial version.

CONFIDENTIAL