VIPA CP 1413plus, Руководство пользователя

Страница: 242 / 328

Programming CP1413plus manual
7-36 Rev. 00/07
7.6.2.3 H1 layer 4 specific functions
7.6.2.3.1 Transmitting data
#include <H1Def.h>
unsigned short WENTRY_C H1SendeDaten(H1_SENDPARAMS W_POINTER send)
This function transmits data over an established connection. Once the function is initiated it will
only return when the transmission was completed successfully or when the connection was
terminated.
Parameters
send
pointer to a structure containing transmission parameters. The
parameters
Vnr
,
DataLen
and
SendLen(=0)
must be specified.
The buffer located at the end of the structure must have a length of
sizeof(H1_SENDPARAMS) + DataLen
.
Bit 15 of element Vnr must be set if the message must form a part of a
blocked
transmission. On the receiving side this bit sets
H1_BLOCKED_DATA in the element Fehler . Bit 15 must never be set
in the last message of a blocked transmission.
Possible values returned by
send.Fehler
are:
0
H1_BAD_LINE
H1_NO_DRIVER
H1_NO_ADAPTER
H1_NOT_SUPPORTED
Returns
< >
0
An error has occurred in the operating system.
0
The send.Fehler element contains one of the above values
Note
This function will only return once the transmission has been completed successfully
or when a timeout occurs. The function may be started and polled on a cyclic basis by
means of the functions
H1StarteSenden/H1AbfrageSenden
. The function
H1SendeDatenOverlapped continues and does not wait for completion.
The driver must have been opened by means of
H1DriverOpen
and a connection
established by means of
H1StarteVerbindung
or
H1StarteVerbindungOverlapped
.
See also
H1SendeDatenEx
H1SendeDatenExOverlapped
H1StarteSenden
H1StarteSendenOverlapped
H1StarteSendenExOverlapped
H1AbfrageSenden
H1GetOverlappedResult