NNS_McsRegisterStreamRecvBuffer

C Specification

#include <nnsys/mcs.h>
void NNS_McsRegisterStreamRecvBuffer(
u16             channel ,
void*            buf,
u32     bufSize);

Arguments

channel Value for identifying a stream. You can specify in the range 0-0x3FFF. 0x4000-0x7FFF is reserved for NITRO-System applications. 0x8000-0xFFFF is reserved for the MCS system.
buf The receive buffer to register.
bufSize The 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 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.

See Also

NNS_McsRegisterRecvCallback, NNS_McsUnregisterRecvResource

Revision History

10/08/2004 Added a description of the channel argument. Added NNS_McsUnregisterRecvResource in See Also.
08/26/2004 Changed the argument channel type.
06/01/2004 Initial version.


CONFIDENTIAL