PN_APP_IOD_cbRecordRead()

uint32_t PN_APP_IOD_cbRecordRead	(	PN_API_IOD_Handle_t *const	pnHandle,
		uint32_t	api,
		uint16_t	arNum,
		uint16_t	sessionKey,
		uint32_t	sequenceNum,
		const PN_API_IOD_DevAddr_t *const	addr,
		uint32_t	recordIndex,
		uint32_t *	bufLen,
		uint8_t *	buffer,
		PN_API_IOD_ErrState_t *	errState
	)

Callback function to read user record data requested by the IO controller.

This function first checks if the asynchronous record read mode is activated. If not, it reads the record data from the corresponding array element and stores it in the buffer returned to Profinet stack. Otherwise, it sends a notification to the stack informing it that the read response will follow later.

Parameters

[in]	pnHandle	Profinet API Handle.
[in]	api	Application Process Identifier.
[in]	arNum	AR number.
[in]	sessionKey	AR session key.
[in]	sequenceNum	Sequence number.
[in]	addr	Geographical address (slot/subslot) of the module/submodule.
[in]	recordIndex	Index of the record.
[in]	bufLen	Length of data to read.
[in]	buffer	Buffer to store the read data.
[in,out]	errState	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.

See also

PN_API_IOD_recordReadCbf