PN_API_IOD_recordWriteResponse()

uint32_t PN_API_IOD_recordWriteResponse	(	PN_API_IOD_Handle_t *const	pnHandle,
		void *	requestHandle,
		uint32_t	dataLength,
		PN_API_IOD_ErrState_t *	pnioStat
	)

Responds to an asynchronous record write request.

If the record write request from the IO controller is to be handled asynchronously, the user application needs to use this function to send the record write 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]	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
uint32_t userDataLength;
PN_API_IOD_ErrState_t pnioStat;
//Fill up userDataLength, pnioStat. Then:
 
status = PN_API_IOD_recordWriteResponse(pnHandle, asyncHandle,
userDataLength, &pnioStat);