nn::uds::CTR::Receive Function

nn::Result Receive(
     const EndpointDescriptor & endpointDesc,
     void * pBuffer,
     size_t * pReceivedSize,
     size_t bufferSize,
     bit8 option = 0x00
);

	Name	Description
in	endpointDesc	Descriptor indicating the endpoint to use. The port and sending source must be attached in advance using the Attach function.
out	pBuffer	Received data storage location. Specify a buffer aligned to 4 bytes.
out	pReceivedSize	Size of the received data. The UDS maximum received data size is UDS_PACKET_PAYLOAD_MAX_SIZE bytes.
in	bufferSize	Size of the receive buffer (pBuffer).
in	option	Receive options. Specifying NO_WAIT here will cause the function to return immediately, even if no data has been received. If not specified, the function will not return until either it receives data or an error occurs.

Returns the function's execution result. Returns one of the Result values listed below.

Value	Description
ResultSuccess	Process was successful.
ResultNotInitialized	When the library is not initialized, returns that the specified endpoint does not exist.
ResultInvalidState	Not in an executable state. Returns that it was executed in a state where it was not connected to the network.
ResultNotAuthorized	Returns that an endpoint that was not attached was specified.
ResultTooLarge	Returns that the bufferSize was smaller than the received data. The desired size is nn::uds::UDS_PACKET_PAYLOAD_MAX_SIZE.
ResultOutOfRange	The specified argument was not in a specifiable range. It is possible it will succeed if you re-execute with an appropriate value for the argument.
ResultWirelessOff	Transitioned to wireless OFF mode. Re-initialization is required.
A value other than the above.	Failed for reasons other than those given above.

Receives data. (There is no way to obtain the address of the sender.)

Non-arguments have the same features as ReceiveFrom. For more information, refer to the ReceiveFrom function reference.

2010/10/15

Expanded the information on the return values.

2010/09/24

Noted that the buffer specified for pBuffer must be 4-byte aligned.

2010/06/14

Initial version.