Ethernet Module Interface (EMI)
– API Description
Copyright IXXAT Automation GmbH
79
IEM Manual, 1.5
4.1.2.43 EMI_ioCyclDataWriteAcquire()
COM_e_ERROR EMI_ioCyclDataWriteAcquire(COM_t_BOARD_REF td_brdRef,
PVOID *ppv_output_data);
Description
This function returns the address of the current output buffer. The application
has to convert the local format of complex data structures to the protocol spe-
cific format.
Remarks
-
Parameter
Dir.
Description
td_brdRef
IN
unique IEM reference
ppv_output_data
OUT
pointer to the output data area of the shared memory
Return Value
Description
COM_k_OK
access to shared memory granted.
COM_k_INVALID_BOARD
invalid IEM reference
COM_k_INVALID_STATE
routine called in invalid state
COM_k_ERROR
parameter error
4.1.2.44 EMI_ioCyclDataWriteRelease()
COM_e_ERROR EMI_ioCyclDataWriteRelease(COM_t_BOARD_REF td_brdRef,
UINT16 w_length);
Description
This function is used to guarantee data consistency during access to the pro-
cess data. It validates the current output buffer. In case of the serial interface
the maximum length of the data to copy into the memory of the IEM has be
provided within the "w_length" parameter, otherwise it is not used. The appli-
cation has to convert the local format of complex data structures to the proto-
col specific format.
Remarks
-
