Ethernet Module Interface (EMI)
– API Description
Copyright IXXAT Automation GmbH
72
IEM Manual, 1.5
odically. The application has to pass the reference value of the previously re-
ceived indication. If the passed parameter ps_confirmation is associated with a
dynamic memory block the application has to release this block after comple-
tion of the transmission. The application will be notified about the completion of
the confirmation transmission. The specification of a unique IEM reference is
not necessary. 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.
Parameter
Dir.
Description
td_conRef
IN
unique connection reference
ps_confirmation
IN
pointer to confirmation structure
s_indRef
IN
unique indication reference
Return Value
Description
COM_k_OK
confirmation successfully issued
COM_k_INVALID_CON
invalid connection reference
COM_k_INVALID_BOARD
invalid IEM reference
COM_k_INVALID_BLOCK
invalid administration block reference
COM_k_INVALID_STATE
routine called in invalid state
COM_k_ERROR
request failed
4.1.2.34 EMI_srvindQuery()
COM_e_ERROR EMI_srvindQuery(COM_t_CONNECTION_REF *ps_conRef,
COM_t_REQUEST_REF s_indRef,
COM_t_SERVICE_DATA *ps_indication,
COM_t_SERVICE_DATA **pps_indication);
Description
If the parameter ps_indication isn't NULL the function copies the content of the
received indication including the dynamic memory block to the specified loca-
tion on the host. If the parameter ps_indication is NULL the address of the in-
dication is returned in parameter pps_indication. In both cases the administra-
tion block including any memory block will automatically be released along
with the transmission of the associated confirmation. Thus the application may
only access these structures before this transmission. Use of the
pps_indication parameter allows for evaluating the indication without another
copy process. Every indication is assembled by EMI_srvServiceHandle. All
parameters of EMI_srvindQuery are validated. The function requires the refer-
ence value of the service indication. This reference value has been signaled to
the application before via a callback function. By means of this reference value
the module can identify the associated confirmation. EMI_srvindQuery may be
