функция TSPI_lineGetCallStatus (tspi.h)
Функция TSPI_lineGetCallStatus возвращает текущее состояние указанного вызова.
Синтаксис
LONG TSPIAPI TSPI_lineGetCallStatus(
HDRVCALL hdCall,
LPLINECALLSTATUS lpCallStatus
);
Параметры
hdCall
Дескриптор поставщика услуг к вызову, который будет запрашиваться для его состояния. Состояние вызова hdCall может быть любым.
lpCallStatus
Указатель на структуру данных изменчивого размера типа LINECALLSTATUS. Эта структура заполняется сведениями о состоянии вызова.
Возвращаемое значение
Возвращает ноль, если функция выполнена успешно, или номер ошибки при возникновении ошибки. Возможные возвращаемые значения:
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL LINEERR_OPERATIONUNAVAIL.
Комментарии
В следующей таблице указано, какие элементы структуры данных LINECALLSTATUS заполняются поставщиком услуг, а какие — с помощью TAPI. Поставщик услуг должен сохранять (не перезаписывать) значения, заполненные TAPI.
| Имя участника | TAPI | Поставщик службы |
|---|---|---|
| dwTotalSize; | X | |
| dwNeededSize; | X | |
| dwUsedSize; | X | |
| dwCallState; | X | |
| dwCallStateMode; | X | |
| dwCallPrivilege; | X | |
| dwCallFeatures; | X | |
| dwDevSpecificSize; | X | |
| dwDevSpecificOffset; | X |
TSPI_lineGetCallStatus возвращает динамическое состояние вызова, тогда как TSPI_lineGetCallInfo возвращает в основном статические сведения о вызове. Сведения о состоянии вызова включают текущее состояние вызова, подробные сведения о режиме, связанные с вызовом в этом состоянии (если таковые имеются), а также список доступных функций TSPI, которые TAPI может вызывать в вызове, пока вызов находится в этом состоянии.
Требования
| Целевая платформа | Windows |
| Header | tspi.h |