Specifications

36 Cross Bus Interface HighWire MTP-2 - 1.2, September 4, 2002
4-3-4. cbi_close Prototype.
CBI_UINT32 cbi_close(
CBI_CORR cbi_correlator)
Description. This function is used to signal the driver that no further messages
will be transferred in either direction to the line card which is identified by the
cbi_correlator.
Parameters.
Returns. CBI_RC_SYNC_COMPLETE if the driver has successfully
processed the
cbi_close()
. Otherwise, a specific error code.
4-3-5. cbi_recv Prototype.
CBI_UINT32 cbi_recv(
CBI_CORR cbi_correlator,
char * ctrl_buf,
CBI_BUF_SIZE ctrl_len,
char * data_buf,
CBI_BUF_SIZE data_len)
Description. This routine gets a message from the library if one is available.
This call does not block. The application must supply the buffers for receiving
the message and is responsible for freeing those buffers when it has finished
with the message.
Parameters.
cbi_correlator The correlator returned by the cbi_open()
cbi_open()cbi_open()
cbi_open() call.
cbi_correlator The correlator that identifies the device from which to
read.
ctrl_buf A pointer to a supplied buffer which will contain the
control portion of any message upon return.
ctrl_len The length of the supplied control buffer.
data_buf A pointer to a supplied buffer which will contain the data
portion of any message upon return. Note that the length
of the data in the data buffer is determined by the
data_len field in the CBI_PKT_HDR structure, which is
always present in the control buffer for messages with an
associated data component.
data_len The length of the supplied data buffer.