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	The size (in bytes) of the receive buffer (pBuffer). The size of the receive buffer must be a multiple of 4.
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
Result::IsSuccess	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 UDS_PACKET_PAYLOAD_MAX_SIZE.
ResultOutOfRange	The specified argument value was not in the valid range for the argument. It is possible it will succeed if you re-execute with an appropriate value for the argument.
ResultWirelessOff	Entered wireless-disabled mode. Re-initialization is required.
ResultMisalignedSize	bufferSize is not appropriate. It is possible it will succeed if you re-execute with an appropriate value for the argument.
ResultMisalignedAddress	pBuffer is not appropriate. It is possible it will succeed if you re-execute with an appropriate value for the argument.
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.

This function is thread-safe.

2011/09/07

Standardized notation for wireless-disabled mode.

2011/03/08

Added a link to UDS_PACKET_PAYLOAD_MAX_SIZE in Return Values.

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.