функция TSPI_lineGetLineDevStatus (tspi.h)
Функция TSPI_lineGetLineDevStatus запрашивает текущее состояние указанного устройства с открытой линией. Возвращаемые сведения являются глобальными для всех адресов в строке.
Синтаксис
LONG TSPIAPI TSPI_lineGetLineDevStatus(
HDRVLINE hdLine,
LPLINEDEVSTATUS lpLineDevStatus
);
Параметры
hdLine
Дескриптор поставщика услуг к строке для запроса.
lpLineDevStatus
Указатель на структуру данных изменчивого размера типа LINEDEVSTATUS. Эта структура заполняется состоянием устройства строки.
Возвращаемое значение
Возвращает ноль, если функция выполнена успешно, или номер ошибки при возникновении ошибки. Возможные возвращаемые значения:
LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL LINEERR_OPERATIONUNAVAIL.
Комментарии
В следующей таблице указано, какие элементы структуры данных LINEDEVSTATUS заполняются с помощью TAPI, а какие — поставщиком услуг. Поставщик услуг должен сохранять (не перезаписывать) значения, заполненные TAPI.
| Имя участника | TAPI | Поставщик службы |
|---|---|---|
| dwTotalSize; | X | |
| dwNeededSize; | X | |
| dwUsedSize; | X | |
| dwNumOpens; | X | |
| dwOpenMediaModes; | X | |
| dwNumActiveCalls; | X | |
| dwNumOnHoldCalls; | X | |
| dwNumOnHoldPendCalls; | X | |
| dwLineFeatures; | X | |
| dwNumCallCompletions; | X | |
| dwRingMode; | X | |
| dwSignalLevel; | X | |
| dwBatteryLevel; | X | |
| dwRoamMode; | X | |
| dwDevStatusFlags; | X | |
| dwTerminalModesSize; | X | |
| dwTerminalModesOffset; | X | |
| dwDevSpecificSize; | X | |
| dwDevSpecificOffset; | X |
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tspi.h |