Ethernet Module Interface (EMI)
– API Description
Copyright IXXAT Automation GmbH
65
IEM Manual, 1.5
BOOL o_blocking);
Description
This function enables the registration of an event and a callback function that
will be called whenever the specified event happens. The callback function re-
turns the event and the IEM reference. The CMD channel is used to transmit
the Register service. To transmit messages via the SD channel the application
has to register a callback function. The associated events are not registered at
the IEM due to their local nature on the host CPU. The function is blocked
waiting on the response if the o_blocking is TRUE, otherwise the application
has to query for the response by means of EMI_cmdCommandRespQuery.
Remarks
The number of events registered by a user (generic and user-specific) must
not exceed COM_k_MAX_CALLBACK_CNT. The registered event callback
will receive the module reference as well as the event type when called.
Parameter
Dir.
Description
td_brdRef
IN
unique IEM reference
dw_event
IN
event the application is interested in. The event is specified bus
protocol specific.
pf_cbk
IN
pointer to user callback function
o_blocking
IN
blocking/non-blocking execution
Return Value
Description
COM_k_OK
event callback registered successfully
COM_k_BUSY
no more space in the event callback array
COM_k_INVALID_STATE
routine called in invalid state
COM_k_INVALID_BOARD
invalid IEM reference
COM_k_ERROR
parameter error
4.1.2.25 EMI_evtEventUnRegister()
COM_e_ERROR EMI_evtEventUnRegister(COM_t_BOARD_REF td_brdRef,
UINT32 dw_event,
BOOL o_blocking);
Description
This function unregisters a certain event callback previously registered by
EMI_cmdRegisterEvent. The CMD channel is used for transmission of the Un-
register service. The function is blocked waiting on the response if the
