Specifications
Ethernet Loop Testing Page
E-5
wrongstate
-
the data link is in a state where a loop cannot
be done.
E.2.1.2 LoopAssisted
The LoopAssisted function is used by a station to determine if some
station in the local network can communicate with the specified remote
station. This may be used if attempts at direct communication have
failed. Loop testing assistance is obtained by a call to the
function:
function LoopAssisted
(
remoteAddress: Addressvalue;
assistantAddress: Addressvalue;
assistanceLeve1:
(transmit,receive,full);
transmitBuffer: Buffervalue;
var receiptNumber: Receiptvalue;
var receiveBuffer: Buffervalue): LoopAssistedStatus;
type LoopAssistedStatus
=
With the following definitions:
remoteAddress
-
the identification of the final destination
station of the test. The address cannot be a multicast address.
assistantAddress
-
the identification of the third party station
to assist in the test. To avoid undesirable levels of multicast
traffic, the address cannot be a multicast address.
assistanceLeve1
-
the amount of assistance to be provided, one of:
transmit
-
the assistant station is only to relay the request,
the
reply
is
to
be
returned from the station possessing the
remoteAddress.
receive
-
the assistant station is only to relay the reply,
the request is to be sent to the station with the
remoteAddress.
full
-
the assistant station is to relay both request and
reply,
transmitBuffer
-
a buffer containing the data to loop.
receiptNumber
-
the request identification used in the LoopPoll or
LoopAbort function to identify this request.
receiveBuffer
-
an
optional buffer
to contain the looped back
data. If no buffer
is
supplied
(i.e.
BufferMaximum
=
O),
the
looped back data is not returned to the caller.