PN_API_IOD_recordReadResponse()

uint32_t PN_API_IOD_recordReadResponse	(	PN_API_IOD_Handle_t *const	pnHandle,
		void *	requestHandle,
		uint8_t *	data,
		uint32_t	dataLength,
		PN_API_IOD_ErrState_t *	pnioStat
	)

Responds to an asynchronous record read request.

If the record read request from the IO controller is to be handled asynchronously, the user application needs to use this function to send the record read response message to the IO controller. The stack expects this function only when PN_API_IOD_recordSetResponseAsync() is used.

Parameters

[in]	pnHandle	Profinet API Handle.
[in]	requestHandle	Request handle obtained from PN_API_IOD_recordSetResponseAsync().
[in]	data	Data provided by the user application.
[in]	dataLength	Length of provided data.
[in]	pnioStat	Profinet status.

Returns

result of the operation as uint32_t.

Return values

PN_API_OK	Success.
PN_API_NOT_OK	Something went wrong.
PN_API_ERR_PARAM	Invalid parameter.

Example

#include "pn_api_iod_record.h"
 
PN_API_IOD_Handle_t* pnHandle = NULL;
uint32_t status;
 
pnHandle = PN_API_IOD_new();
 
//Within the implementation of record read/write callback function
void* asyncHandle = NULL;
status = PN_API_IOD_recordSetResponseAsync(pnHandle, &asyncHandle);
 
//Later in the user application
uint8_t *userData;
uint32_t userDataLength;
PN_API_IOD_ErrState_t pnioStat;
//Fill up userData, userDataLength, pnioStat. Then:
 
status = PN_API_IOD_recordReadResponse(pnHandle, asyncHandle,
userData, userDataLength, &pnioStat);