Retrieves the most recent input byte received on a particular switch input stream and timeslot.
S16 TxSampleInput (S16 handle, STREAM_T iStream, TIMESLOT_T iTimeslot, DATA_T *iSample)
Argument |
Description |
handle |
Handle returned from a previous call to TxMvipOpen for the desired board. |
iStream |
Input stream number. Must be: 0 through 31 for H.100/H.110 80 - 83 for T1/E1 trunks 1 - 4 84 - 87 for T1/E1 trunks 5 - 8 (CompactPCI TX only) |
iTimeslot |
Input timeslot number. Must be: 0 through 127 for H.100/H.110 0 through 23 for T1 or J1 interfaces 0 through 31 for E1 interfaces |
iSample |
Pointer to where the current value received from the stream and timeslot is returned to the caller. |
Return value |
Description |
SUCCESS |
|
MVIP_INVALID_HANDLE |
Invalid handle. |
MVIP_INVALID_STREAM |
Output or source stream number is out of range. |
MVIP_INVALID_TIMESLOT |
Output or source timeslot number is out of range. |
MVIP_NO_RESOURCES |
MVIP adapter is not present on the communications processor. |
The data returned by TxSampleInput can change every 125 microseconds, and may not be accurate by the time the application receives the data. Sampling is most useful when testing a channel where a constant pattern is being transmitted.