nn::nex::DirectStream::SendReliable Member Function

Syntax

qBool SendReliable(
     CallContext * pContext,
     StationID id,
     SubStreamID subStreamID,
     const qByte * pBuffer,
     qUnsignedInt32 size
);

Parameters

Name Description
inout pContext Specifies the call context.
in id Specifies the StationID for the destination station.
in subStreamID Specifies the SubStreamID used for sending. Shared with the system, SubStreamIDDefine::SYSTEM is equivalent to performing reliable communications with Send.
in pBuffer Specifies the data to send.
in size Specifies the size of the send data. Set this parameter to 32,768 or less for reliable communication. For other types of communication, set it to 1,300 or less (1,250 or less for topologies other than P2P).

Return Values



Value Description
true The send request was successful.
false The send request failed.

Description

Sends reliable data with a specified SubStreamID to a specific station.

By specifying the call context, you can detect whether reliable communication arrived with an asynchronous process. It is Success when arrival is confirmed. If arrival cannot be confirmed, it does not complete. 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 SendReliable function.

See Also

SubStreamIDDefine, StreamSettings::SetMaxUserReliableSubStreams

Revision History

2012/10/29
Initial version.

CONFIDENTIAL