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

Статья
08/26/2023

Структура LINEDEVSTATUS описывает текущее состояние устройства линии. Функция lineGetLineDevStatus и функция TSPI_lineGetLineDevStatus возвращают структуру LINEDEVSTATUS .

Синтаксис

typedef struct linedevstatus_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwNumOpens;
  DWORD dwOpenMediaModes;
  DWORD dwNumActiveCalls;
  DWORD dwNumOnHoldCalls;
  DWORD dwNumOnHoldPendCalls;
  DWORD dwLineFeatures;
  DWORD dwNumCallCompletions;
  DWORD dwRingMode;
  DWORD dwSignalLevel;
  DWORD dwBatteryLevel;
  DWORD dwRoamMode;
  DWORD dwDevStatusFlags;
  DWORD dwTerminalModesSize;
  DWORD dwTerminalModesOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
  DWORD dwAvailableMediaModes;
  DWORD dwAppInfoSize;
  DWORD dwAppInfoOffset;
} LINEDEVSTATUS, *LPLINEDEVSTATUS;

Члены

dwTotalSize

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

dwNeededSize

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

dwUsedSize

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

dwNumOpens

Количество активных открытий на устройстве линии.

dwOpenMediaModes

Битовый массив, указывающий, для каких типов носителей открыто устройство линии.

dwNumActiveCalls

Количество вызовов в строке в состояниях вызовов, отличных от состояния простоя, onhold, onholdpendingtransfer и onholdpendingconference.

dwNumOnHoldCalls

Количество вызовов в строке в состоянии удержания .

dwNumOnHoldPendCalls

Количество вызовов в строке в состоянии onholdpendingtransfer или onholdpendingconference .

dwLineFeatures

Функции, связанные со строками, которые в настоящее время доступны в этой строке. Этот элемент использует одну или несколько констант LINEFEATURE_.

dwNumCallCompletions

Количество незавершенных запросов на завершение вызова в строке.

dwRingMode

Текущий кольцевой режим на устройстве линии.

dwSignalLevel

Текущий уровень сигнала подключения на линии. Это значение в диапазоне 0x00000000 (самый слабый сигнал) до 0x0000FFFF (самый сильный сигнал).

dwBatteryLevel

Текущий уровень заряда батареи оборудования линейного устройства. Это значение в диапазоне 0x00000000 (пустая батарея) до 0x0000FFFF (заряд батареи).

dwRoamMode

Текущий режим перемещения для устройства линии. Этот элемент использует одну из констант LINEROAMMODE_.

dwDevStatusFlags

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

dwTerminalModesSize

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

dwTerminalModesOffset

Смещение от начала структуры к массиву текущих режимов терминала в байтах. Этот массив индексируется по идентификаторам терминалов в диапазоне от нуля до dwNumTerminals минус один. Каждая запись в массиве задает текущие режимы терминала для соответствующего набора терминалов с помощью функции lineSetTerminal для этой строки. Каждая запись представляет собой DWORD , указывающее одну или несколько констант LINETERMMODE_. Размер массива определяется параметром dwTerminalModesSize.

dwDevSpecificSize

Размер поля устройства с изменяемого размера в байтах. Если сведения, относящиеся к устройству, являются указателем на строку, размер должен включать признак конца null .

dwDevSpecificOffset

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

dwAvailableMediaModes

Указывает типы мультимедиа, которые могут вызываться при новых вызовах, созданных на этом устройстве линии, когда член dwLineFeatures указывает, что новые вызовы возможны. Если этот элемент равен нулю, это означает, что поставщик услуг либо не знает, либо не может указать, какие типы мультимедиа доступны. В этом случае любой или все типы мультимедиа, указанные в элементе dwMediaModes в LINEDEVCAPS , могут быть доступны.

dwAppInfoSize

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

dwAppInfoOffset

Смещение от начала структуры к массиву структур LINEAPPINFO . Элемент dwNumOpens указывает количество элементов в массиве. Каждый элемент в массиве идентифицирует приложение, в котором открыта строка. Размер массива определяется dwAppInfoSize.