SPXGetConnectionStatus
| На входе: | BX | = | 15h. |
| DX | = | Номер канала связи. | |
| ES:SI | = | Указатель на буфер размером 44 байта. | |
| На выходе: | AL | = | Код завершения: 00h - канал активен; EEh - указанный канал не существует. |
С помощью функции SPXGetConnectionStatus программа может проверить состояние канала. Если канал существует, в буфер, адрес которого задан в регистрах ES:SI, записывается информация о состоянии канала.
Приведем формат буфера в виде структуры:
struct CSB { unsigned char ConnectionState; unsigned char ConnectionFlags; unsigned char SrcConnectionID[2]; unsigned char DestConnectionID[2]; unsigned char SeqNumber[2]; unsigned char AckNumber[2]; unsigned char AllocNumber[2]; unsigned char RemoteAckNumber[2]; unsigned char RemoteAllocNumber[2]; unsigned char ConnectionSocket[2]; unsigned char ImmAddress[6]; unsigned char DestNetwork[4]; unsigned char DestNode[6]; unsigned char DestSocket[2]; unsigned char RetransmissionCount[2]; unsigned char EstimatedRoundtripDelay[2]; unsigned char RetransmittedPackets[2]; unsigned char SuppressedPackets[2]; };
Все поля в этой структуре имеют "перевернутый" формат, в котором младшие байты записаны по старшему адресу.
Поле ConnectionState отображает текущее состояние канала:
| 01h | драйвер SPX находится в состоянии ожидания приема пакета, посылаемого функцией SPXEstablishConnection; |
| 02h | драйвер SPX пытается создать канал с удаленной рабочей станцией после вызова функции SPXEstablishConnection; |
| 03h | канал создан; |
| 04h | канал закрыт. |
Поле ConnectionFlags содержит флаги, которые используются драйвером SPX для управления каналом. Бит 02h, в частности, управляет использованием системы периодической проверки связи. Если этот бит установлен в единицу, для данного канала выполняется периодическая проверка связи.
Поле SrcConnectionID содержит номер канала, присвоенный локальной станции. Это тот самый номер канала, который надо загружать в регистр DX перед использованием функций SPX.
Поле DestConnectionID содержит номер канала, присвоенный программе, работающей на удаленной станции.
Поле SeqNumber содержит последовательный номер, который SPX будет использовать для пересылки следующего пакета по каналу.
Поле AckNumber содержит последовательный номер следующего пакета, который должен быть принят по каналу от удаленной станции.
Поле AllocNumber используется драйвером SPX для контроля за пакетами, которые были переданы, но для которых еще не пришло подтверждение о приеме. В нем содержится количество свободных буферов, распределенных для приема пакетов.
Поле RemoteAckNumber содержит номер следующего пакета, который должен быть принят на удаленной станции от локальной станции.
Поле RemoteAllocNumber имеет назначение, аналогичное назначению поля AllocNumber, но относится к удаленной станции.
Поле ConnectionSocket содержит номер сокета, который используется драйвером SPX для приема и передачи пакетов по данному каналу.
Поле ImmAddress содержит физический сетевой адрес станции, которой будут передаваться пакеты. Если станция-адресат находится в другой сети, в этом поле будет находиться адрес моста, через который пакет сможет дойти до адресата.
Поля DestNetwork, DestNode, DestSocket содержат компоненты полного сетевого адреса удаленной станции, с которой локальная станция работает по данному каналу, - номер сети, физический адрес станции в сети и номер сокета.
В поле RetransmissionCount находится максимальное значение количества повторных передач пакетов, по достижении которого SPX делает вывод о невозможности завершения передачи.
Поле EstimatedRoundtripDelay содержит время (в тиках таймера), в течение которого SPX ждет прихода подтверждения приема пакета от удаленной станции. По истечении этого времени SPX начинает выполнять повторную передачу пакета.
Поле RetransmittedPackets содержит количество выполненных повторных передач пакета.
Поле SuppressedPackets содержит количество отвергнутых пакетов. Пакеты могут быть отвергнуты, если они уже были приняты ранее или в настоящий момент нет свободных ECB для их приема.
