Структура LINECALLSTATUS (tapi.h)

Статья
08/26/2023

Структура LINECALLSTATUS описывает текущее состояние вызова. Сведения в этой структуре зависят от возможностей устройства по адресу, владения вызовом вызывающего приложения и текущего состояния запрашиваемого вызова. Функции lineGetCallStatus и TSPI_lineGetCallStatus возвращают структуру LINECALLSTATUS .

Синтаксис

typedef struct linecallstatus_tag {
  DWORD      dwTotalSize;
  DWORD      dwNeededSize;
  DWORD      dwUsedSize;
  DWORD      dwCallState;
  DWORD      dwCallStateMode;
  DWORD      dwCallPrivilege;
  DWORD      dwCallFeatures;
  DWORD      dwDevSpecificSize;
  DWORD      dwDevSpecificOffset;
  DWORD      dwCallFeatures2;
#if ...
  SYSTEMTIME tStateEntryTime;
#else
  WORD       tStateEntryTime[8];
#endif
} LINECALLSTATUS, *LPLINECALLSTATUS;

Члены

dwTotalSize

Общий размер, выделенный для этой структуры данных, в байтах.

dwNeededSize

Размер для этой структуры данных, необходимый для хранения всей возвращаемой информации, в байтах.

dwUsedSize

Размер части структуры данных, содержащей полезную информацию, в байтах.

dwCallState

Текущее состояние вызова с использованием одной из констант LINECALLSTATE_.

dwCallStateMode

Интерпретация члена dwCallStateMode зависит от состояния вызова. Во многих случаях значение будет равно нулю. В следующей таблице показаны типы dwCallStateMode для заданного значения dwCallState .

dwCallState	Значение
LINECALLSTATE_BUSY	Константы LINEBUSYMODE_
LINECALLSTATE_CONNECTED	константы LINECONNECTEDMODE_
LINECALLSTATE_DIALTONE	Константы LINEDIALTONEMODE_
LINECALLSTATE_DISCONNECTED	Константы LINEDISCONNECTMODE_
LINECALLSTATE_OFFERING	Константы LINEOFFERINGMODE_
LINECALLSTATE_SPECIALINFO	Константы LINESPECIALINFO_

dwCallPrivilege

Привилегия приложения для этого вызова. Этот элемент использует одну или несколько констант LINECALLPRIVILEGE_.

dwCallFeatures

Флаги, указывающие функции API телефонии, которые могут вызываться при вызове, учитывая доступность функции в возможностях устройства, текущее состояние вызова и владение вызовом вызывающего приложения. Ноль указывает, что соответствующий компонент не может быть вызван приложением при вызове в его текущем состоянии; значение , указывающее, что компонент можно вызвать. Этот элемент использует константы LINECALLFEATURE_.

dwDevSpecificSize

Размер поля устройства в байтах.

dwDevSpecificOffset

Смещение от начала структуры к полю устройства с разными размерами. Размер поля определяется dwDevSpecificOffset.

dwCallFeatures2

Указывает, что при вызове можно вызывать дополнительные функции, учитывая доступность функции в возможностях устройства, текущее состояние вызова и владение вызовом вызывающего приложения. Расширение члена dwCallFeatures . Этот элемент использует константы LINECALLFEATURE2_.

tStateEntryTime

Координированное универсальное время, в которое было введено текущее состояние вызова.

tStateEntryTime[8]

Координированное универсальное время, в которое было введено текущее состояние вызова.

Приложению отправляется сообщение LINE_CALLSTATE при изменении состояния вызова. Это сообщение предоставляет только новое состояние вызова. Дополнительное состояние вызова доступно с помощью lineGetCallStatus.

Члены dwCallFeatures2 и tStateEntryTime доступны только для приложений, которые открывают устройство с api версии 2.0 или более поздней.