Ethernet Module Interface (EMI)
– API Description
Copyright IXXAT Automation GmbH
68
IEM Manual, 1.5
of EMI_srvrespRespQuery. The SD channel is used for the transmission of the
Close service.
Parameter
Dir.
Description
td_brdRef
IN
unique IEM reference
td_conRef
IN
handle to identify the service channel
ptd_reqRef
OUT
pointer to the variable receiving the reference of the request
ps_request
IN
pointer to service request
Return Value
Description
COM_k_OK
remote channel closed
COM_k_INVALID_BOARD
invalid IEM reference
COM_k_INVALID_STATE
routine called in invalid state
COM_k_ERROR
error while closing the channel
4.1.2.29 EMI_srvreqSend()
COM_e_ERROR EMI_srvreqSend(COM_t_BOARD_REF td_brdRef,
COM_t_CONNECTION_REF td_conRef,
const COM_t_SERVICE_DATA *ps_request,
COM_t_REQUEST_REF *ptd_reqRef,
UINT8 *pb_target);
Description
This function enquires a service request of a previously opened channel. For
this purpose the structure that is referred by the parameter ps_request is cop-
ied. Any possibly existing associated memory block is not copied. The applica-
tion may send several requests before the first response is received (window
size > 1). The queue is periodically checked for pending requests. The service
requests are transmitted via the SD channel. The message is automatically
fragmented if necessary. To transfer all pending requests the application has
to call EMI_srvServiceHandle periodically. The function EMI_srvreqSend re-
turns a unique reference value for every passed service request. By means of
this reference value the received response can be identified. An administration
block of the ABM unit is allocated along with the insertion of the request. If the
passed ps_request parameter is associated with a dynamic memory block the
application has to deallocate this memory block after transmission of the re-
quest. Up to this time the application may read-only the content of the block.
The application will be notified about the completion of the request transmis-
sion respectively the timeout of the expected response via a callback mecha-
nism. The callback function delivers the reference value of the request. Thus
polling of all pending requests by the application can be avoided. The applica-
tion may specify a location ps_target inside of the shared memory to receive