Intermec 5055 Reference Guide

Page of 216
im_transmit_buffer
5-73
5
im_transmit_buffer
Purpose:
This function transmits the contents of a data buffer through the serial communications
port. This function continues operating until the buffer transmission is complete or until
an error status is detected.
Syntax:
#include "im5055.h"
IM_STATUS im_transmit_buffer
    (IM_COM_PORT 
port_id
,
    IM_USHORT 
length
,
    IM_UCHAR far 
*data_buffer,
    
IM_LTIME
 timeout
);
IN Parameters:
port_id    Identifies the communications port. Use this constant:
IM_COM1    COM1 selected.
IM_COM2    COM2 selected.
IM_NET    Network selected.
length    Length of the buffer.
data_buffer    Far pointer to the data array that you want to transmit.
timeout    Specifies the transmit timeout period. Either enter a number from 0 to 65,534
to indicate the length of the timeout in milliseconds, or choose one of these constants:
IM_INFINITE_NET_TIMEOUT    Never timeout.
IM_ZERO_TIMEOUT    No wait.
OUT Parameters:
None.
Return Value:
This function returns one of these codes:
IM_SUCCESS    Transmit completed.
IM_NOT_READY    Network is not active or not properly configured.
IM_NET_BAD_DATA    Data pointer is null or invalid data length.
IM_NET_DATA_LENGTH    Data length exceeds 1K.
IM_NET_CONFIG_ERROR    Incorrect configuration or hardware fault.
Notes:
Once the transmission begins, program control remains inside this function until the
transmission is completed. There is no way to check the transmission status while
transmitting.
To receive data from the radio network, im_transmit_buffer requires that you provide
radio parameters such as the terminal number, host identification, or LAN identification
at one time per application. The inquiry impacts all functions that provide radio
communication (im_receive_field, im_receive_input, im_receive_buffer).
See Also:
im_receive_buffer