nn::nex::DirectStream::SendUnreliable Member Function

Syntax

qResult SendUnreliable(
     StationID id,
     const qByte * pBuffer,
     qUnsignedInt32 size
);

Arguments

Name Description
in id Specifies the StationID for the destination station.
in pBuffer Specifies the data to send.
in size Specifies the size of the send data. Use 1300 or less (or 1250 or less when not using a P2P topology).

Return Values



Value Description
QSUCCESS(Core, Success) The send request was successful.
QERROR(Core, InvalidSequence) The DirectStream is not enabled.
QERROR(Transport, Unknown) The PRUDPUserProtocol::GetInstance function is NULL.
QERROR(Core, CallInitiationFailure) Initialization of the call context failed.
QERROR(Core, InvalidArgument) Invalid argument value. (pBuffer is NULL or size has been exceeded.))
QERROR(Transport, ConnectionFailure) Connection was not established with the destination station.
QERROR(Transport, InvalidStation) The station being sent to does not exist. (It is either connecting or never existed.))
QERROR(Transport, PacketBufferFull) Data could not be sent due to packet buffer exhaustion. The application needs to handle this. (The return of this error by this function is not a fatal error, which can be retrieved with NetZ::GetFatalError.)

Description

Sends unreliable data to a specific station.

To get the StationID, use the Station::GetStationID function.

Returns a PacketBufferFull error when the packet buffer does not have enough space. This error indicates that the packet buffer was temporarily insufficient. Increase the buffer as needed. For more information about packet buffer settings, see PacketBufferManager.

Revision History

2012/11/27
Added QRESULT_ERROR(Transport, PacketBufferFull) to the return values.
2012/10/31
Initial version.

CONFIDENTIAL