Ethernet Module Interface (EMI)
– API Description
Copyright IXXAT Automation GmbH
69
IEM Manual, 1.5
the data of the response. The application has to convert the protocol specific
format of complex data structures to the local format.
Remarks
The result of the service request is signaled via a separate channel. Use the
function EMI_srvrespQuery() to check for the result of the request.
Parameter
Dir.
Description
td_brdRef
IN
unique IEM reference
td_conRef
IN
unique connection reference
ps_request
IN
pointer to request structure
ptd_reqRef
OUT
pointer to variable receiving the reference of the request
pb_target
IN
pointer to address in shared memory receiving the response
data
Return Value
Description
COM_k_OK
request successfully issued
COM_k_INVALID_BOARD
invalid IEM reference
COM_k_INVALID_STATE
routine called in invalid state
COM_k_NO_RSRC
no more resources (e.g. administration blocks)
4.1.2.30 EMI_srvrespQuery()
COM_e_ERROR EMI_srvrespQuery( COM_t_CONNECTION_REF *ps_conRef,
COM_t_REQUEST_REF td_reqRef,
COM_t_SERVICE_DATA *ps_response,
COM_t_SERVICE_DATA **pps_response);
Description
If the parameter ps_response isn't NULL the function copies the content of the
requested response including the dynamic memory block to the specified loca-
tion on the host. Afterwards the administration and memory block are released
automatically. If the parameter ps_response is NULL the address of the re-
sponse is returned in parameter pps_response. In this case the application
has to call EMI_servrespServiceCompleted after evaluating the response con-
tent to release the administration and memory block of the response. Use of
the pps_response parameter allows for evaluating the response without an-
other
copy
process.
Every
response
is
assembled
by
EMI_srvrespServiceHandle by means of srvrespQuery. All parameters of
EMI_srvrespQuery are validated. The specification of a unique IEM reference
is not required. Any IEM can be unambiguously identified by means of the ser-
vice reference value. The application has to convert the protocol specific for-
mat of complex data structures to the local format.