PN_API_IOD_getRealSubmodList()

uint32_t PN_API_IOD_getRealSubmodList	(	PN_API_IOD_Handle_t *const	pnHandle,
		PN_API_IOD_RealSubmod_t **	realSubmodList,
		uint32_t *	realSubmodListSize
	)

Gets information about real submodule list.

This function gets real submodule list information from the stack and returns a pointer to it to the user application.

Parameters

[in]	pnHandle	Profinet API Handle.
[out]	realSubmodList	Submodule list to be returned.
[in]	realSubmodListSize	Size of realSubmodList.

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_device.h"
#include "pn_api_iod_startup.h"
 
PN_API_IOD_Handle_t* pnHandle = NULL;
uint32_t status;
 
pnHandle = PN_API_IOD_new();
 
//Prepare and call PN_API_IOD_startup()
...
 
uint32_t realSubmodListSize = 0;
PN_API_IOD_RealSubmod_t *realSubmodList;
 
status = PN_API_IOD_getRealSubmodList(pnHandle, &realSubmodList, &realSubmodListSize);