Intermec 5055 Reference Guide
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.
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
(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:
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.
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).
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