nn::nex::DirectStream::Send Member Function

Syntax

qResult Send(
     StationID id,
     StreamType type,
     const qByte * pBuffer,
     qUnsignedInt32 size
);

qBool Send(
     CallContext * pContext,
     StationID id,
     StreamType type,
     const qByte * pBuffer,
     qUnsignedInt32 size
);

Overloaded Member Functions

Send ( StationID, StreamType, const qByte *, qUnsignedInt32 ) Sends data to a specific station.
Send ( CallContext *, StationID, StreamType, const qByte *, qUnsignedInt32 ) Sends data to a specific station.

Description of Send ( StationID, StreamType, const qByte *, qUnsignedInt32 )

To get the StationID, use the Station::GetStationID function. When using reliable communication to send data, the ReliableSendBufferFull error is returned if the send buffer is full. The ReliableSendBufferFull error indicates that the send buffer was temporarily full, so when this error occurs, dispatch the data and then wait briefly before trying to send the data again.

Returns a PacketBufferFull error when the packet buffer does not have enough space. This error indicates that the packet buffer was temporarily insufficient. Dispatch the data and wait briefly before trying to send the data again. If PacketBufferFull occurs at a high frequency, take measures to increase the packet buffer. For more information about packet buffer settings, see PacketBufferManager.

Description of Send ( CallContext *, StationID, StreamType, const qByte *, qUnsignedInt32 )

By specifying the call context, you can detect whether reliable communication arrived with an asynchronous process. For reliable communication, if arrival was confirmed, it returns Success. If arrival cannot be confirmed, it does not complete. For non-reliable communication, the call context is finalized at the end of the call. Even if the call context is canceled, reliable communication for which the send request succeeded continues to be sent.
To get the StationID, use the Station::GetStationID function. You can get the result from when the call context was finalized with the CallContext::GetOutcome function. For the possible call context processing results, see the qResult-type return values for the Send function.


CONFIDENTIAL