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

Статья
03/08/2023

Структура LINEADDRESSCAPS описывает возможности указанного адреса. Функция lineGetAddressCaps и функция TSPI_lineGetAddressCaps возвращают структуру LINEADDRESSCAPS .

Синтаксис

typedef struct lineaddresscaps_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwLineDeviceID;
  DWORD dwAddressSize;
  DWORD dwAddressOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
  DWORD dwAddressSharing;
  DWORD dwAddressStates;
  DWORD dwCallInfoStates;
  DWORD dwCallerIDFlags;
  DWORD dwCalledIDFlags;
  DWORD dwConnectedIDFlags;
  DWORD dwRedirectionIDFlags;
  DWORD dwRedirectingIDFlags;
  DWORD dwCallStates;
  DWORD dwDialToneModes;
  DWORD dwBusyModes;
  DWORD dwSpecialInfo;
  DWORD dwDisconnectModes;
  DWORD dwMaxNumActiveCalls;
  DWORD dwMaxNumOnHoldCalls;
  DWORD dwMaxNumOnHoldPendingCalls;
  DWORD dwMaxNumConference;
  DWORD dwMaxNumTransConf;
  DWORD dwAddrCapFlags;
  DWORD dwCallFeatures;
  DWORD dwRemoveFromConfCaps;
  DWORD dwRemoveFromConfState;
  DWORD dwTransferModes;
  DWORD dwParkModes;
  DWORD dwForwardModes;
  DWORD dwMaxForwardEntries;
  DWORD dwMaxSpecificEntries;
  DWORD dwMinFwdNumRings;
  DWORD dwMaxFwdNumRings;
  DWORD dwMaxCallCompletions;
  DWORD dwCallCompletionConds;
  DWORD dwCallCompletionModes;
  DWORD dwNumCompletionMessages;
  DWORD dwCompletionMsgTextEntrySize;
  DWORD dwCompletionMsgTextSize;
  DWORD dwCompletionMsgTextOffset;
  DWORD dwAddressFeatures;
  DWORD dwPredictiveAutoTransferStates;
  DWORD dwNumCallTreatments;
  DWORD dwCallTreatmentListSize;
  DWORD dwCallTreatmentListOffset;
  DWORD dwDeviceClassesSize;
  DWORD dwDeviceClassesOffset;
  DWORD dwMaxCallDataSize;
  DWORD dwCallFeatures2;
  DWORD dwMaxNoAnswerTimeout;
  DWORD dwConnectedModes;
  DWORD dwOfferingModes;
  DWORD dwAvailableMediaModes;
} LINEADDRESSCAPS, *LPLINEADDRESSCAPS;

Члены

dwTotalSize

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

dwNeededSize

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

dwUsedSize

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

dwLineDeviceID

Идентификатор устройства линии, с которым связан этот адрес.

dwAddressSize

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

dwAddressOffset

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

dwDevSpecificSize

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

dwDevSpecificOffset

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

dwAddressSharing

Режим предоставления общего доступа к адресу. Этот элемент может быть одной из констант LINEADDRESSSHARING_.

dwAddressStates

Изменение состояний адресов, о которых приложение может получать уведомления в сообщении LINE_ADDRESSSTATE. Этот элемент использует одну или несколько констант LINEADDRESSSTATE_.

dwCallInfoStates

Элементы сведений о вызовах, значимые для всех вызовов по этому адресу. Приложение может получать уведомления об изменениях в некоторых из этих состояний в LINE_CALLINFO сообщениях. Этот элемент использует одну или несколько констант LINECALLINFOSTATE_.

dwCallerIDFlags

Типы сведений об идентификаторах сторон, которые могут быть предоставлены для вызовов по этому адресу. Вызывающий объект является инициатором сеанса. Одна или несколько констант LINECALLPARTYID_.

dwCalledIDFlags

Типы сведений об идентификаторах сторон, которые могут быть предоставлены для вызовов по этому адресу. Здесь "называется" относится к исходному назначению. Одна или несколько констант LINECALLPARTYID_.

dwConnectedIDFlags

Типы сведений об идентификаторах сторон, которые могут быть предоставлены для вызовов по этому адресу. Одна или несколько констант LINECALLPARTYID_.

dwRedirectionIDFlags

Типы сведений об идентификаторах сторон, которые могут быть предоставлены для вызовов по этому адресу. Здесь "перенаправление" является новым назначением. Одна или несколько констант LINECALLPARTYID_.

dwRedirectingIDFlags

Типы сведений об идентификаторах сторон, которые могут быть предоставлены для вызовов по этому адресу. Здесь "перенаправление" — это адрес, который вызвал перенаправление. Одна или несколько констант LINECALLPARTYID_.

dwCallStates

Состояния вызовов, которые можно сообщить для звонков по этому адресу. Этот элемент использует одну или несколько констант LINECALLSTATE_.

dwDialToneModes

Режимы звонка, которые можно сообщить для звонков, выполненных по этому адресу. Этот элемент имеет смысл только в том случае, если можно сообщить о состоянии вызова dialtone . Этот элемент использует одну или несколько констант LINEDIALTONEMODE_.

dwBusyModes

Режимы занятости, которые можно сообщить для вызовов, выполненных по этому адресу. Этот элемент имеет смысл только в том случае, если можно сообщить о состоянии занятого звонка. Этот элемент использует одну или несколько констант LINEBUSYMODE_.

dwSpecialInfo

Специальные типы сведений, которые могут быть переданы для вызовов, выполненных по этому адресу. Этот элемент имеет смысл только в том случае, если можно сообщить о состоянии вызова specialInfo . Этот элемент использует одну или несколько констант LINESPECIALINFO_.

dwDisconnectModes

Режимы отключения, которые можно сообщить для вызовов, выполненных по этому адресу. Этот элемент имеет смысл только в том случае, если можно сообщить о состоянии отключенного вызова. Этот элемент использует одну или несколько констант LINEDISCONNECTMODE_.

dwMaxNumActiveCalls

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

dwMaxNumOnHoldCalls

Максимальное количество вызовов по адресу, который может находиться на удержании.

dwMaxNumOnHoldPendingCalls

Максимальное количество вызовов по адресу, которое может находиться на удержании в ожидании передачи или конференции.

dwMaxNumConference

Максимальное количество сторон, которые могут присоединиться к одной конференции по этому адресу.

dwMaxNumTransConf

Количество сторон (включая "self"), которые можно добавить в конференции, которая инициируется в качестве универсального консультационного звонка с помощью lineSetupTransfer.

dwAddrCapFlags

Упакованные битовые флаги, описывающие различные возможности адреса. Этот элемент использует одну или несколько констант LINEADDRCAPFLAGS_.

dwCallFeatures

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

dwRemoveFromConfCaps

Возможности адреса для удаления звонков из конференции. Этот элемент использует одну из констант LINEREMOVEFROMCONF_.

dwRemoveFromConfState

Использует константы LINECALLSTATE_ для указания состояния звонка после его удаления из конференции.

dwTransferModes

Возможности адреса для разрешения запросов на передачу. Этот элемент использует одну из констант LINETRANSFERMODE_.

dwParkModes

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

dwForwardModes

Для этого адреса доступны различные режимы переадресации. Этот элемент использует константы LINEFORWARDMODE_.

dwMaxForwardEntries

Максимальное количество записей, которые можно передать в lineForward в параметре lpForwardList .

dwMaxSpecificEntries

Максимальное количество записей в параметре lpForwardList , передаваемых в lineForward , которые могут содержать инструкции переадресации на основе определенного идентификатора вызывающего объекта (выборочная переадресация вызовов). Этот элемент равен нулю, если выборочная переадресация вызовов не поддерживается.

dwMinFwdNumRings

Минимальное количество колец, которое можно задать, чтобы определить, когда звонок официально считается "без ответа".

dwMaxFwdNumRings

Максимальное количество колец, которое можно задать, чтобы определить, когда вызов официально считается "без ответа". Если это число колец невозможно задать, то dwMinFwdNumRings и dwMaxNumRings равны.

dwMaxCallCompletions

Максимальное количество одновременных запросов на завершение звонка, которые могут быть невыполненными на этом устройстве линии. Ноль означает, что завершение вызова недоступно.

dwCallCompletionConds

Различные условия вызова, при которых можно запросить завершение вызова. Этот элемент использует одну или несколько констант LINECALLCOMPLCOND_.

dwCallCompletionModes

Способ выполнения вызова. Этот элемент использует одну из констант LINECALLCOMPLMODE_.

dwNumCompletionMessages

Количество сообщений о завершении вызова, из которых можно выбрать при использовании параметра LINECALLCOMPLMODE_MESSAGE. Отдельные сообщения идентифицируются по значениям в диапазоне от нуля до одного меньше , чем dwNumCompletionMessages.

dwCompletionMsgTextEntrySize

Размер каждого описания текста завершения вызова, заданного dwCompletionMsgTextSize и dwCompletionMsgTextOffset, в байтах.

dwCompletionMsgTextSize

Размер текста завершения вызова в байтах.

dwCompletionMsgTextOffset

Смещение от начала этой структуры данных до поля изменяющегося размера, содержащего описательный текст о каждом из сообщений о завершении вызова. Каждое сообщение имеет длину dwCompletionMsgTextEntrySize в байтах. Строковый формат этих текстовых описаний обозначается dwStringFormat в возможностях устройства строки. Размер поля определяется dwCompletionMsgTextSize.

dwAddressFeatures

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

dwPredictiveAutoTransferStates

Состояние вызова или состояния, в которых можно настроить звонок, выполненный прогнозным абонентом, для автоматической передачи звонка на другой адрес; одна или несколько констант LINECALLSTATE_. Значение 0 указывает, что автоматическая передача на основе состояния вызова недоступна.

dwNumCallTreatments

Количество записей в массиве структур LINECALLTREATMENTENTRY , разделенных dwCallTreatmentListSize и dwCallTreatmentListOffset.

dwCallTreatmentListSize

Размер массива обработки вызовов в байтах.

dwCallTreatmentListOffset

Смещение от начала структуры до массива структур LINECALLTREATMENTENTRY , которые определяют обработки вызовов, поддерживаемые адресом (которые можно выбрать с помощью lineSetCallTreatment). Значением является dwNumCallTreatments times SIZEOF(LINECALLTREATMENTENTRY). Размер поля определяется параметром dwCallTreatmentListSize.

dwDeviceClassesSize

Размер списка поддерживаемых классов устройств в байтах.

dwDeviceClassesOffset

Смещение от начала структуры к строке, состоящей из идентификаторов классов устройств, поддерживаемых по этому адресу для использования с lineGetID. Элементы разделяются символами NULL , а за последним идентификатором класса следуют два символа NULL . Размер поля определяется dwDeviceClassesSize.

dwMaxCallDataSize

Максимальное число байтов, которое приложение может задать в LINECALLINFO с помощью lineSetCallData.

dwCallFeatures2

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

dwMaxNoAnswerTimeout

Максимальное значение в секундах, которое можно задать в элементе dwNoAnswerTimeout в LINECALLPARAMS при выполнении вызова. Значение 0 указывает, что автоматический отказ от вызовов без ответа не поддерживается поставщиком услуг или что значение времени ожидания не регулируется приложениями.

dwConnectedModes

LINECONNECTEDMODE_ значения, которые могут отображаться в элементе dwCallStateModeLINECALLSTATUS и в сообщениях LINE_CALLSTATE для вызовов по этому адресу.

dwOfferingModes

LINEOFFERINGMODE_ значения, которые могут отображаться в элементе dwCallStateModelineCALLSTATUS и в LINE_CALLSTATE сообщениях для вызовов по этому адресу.

dwAvailableMediaModes

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

Старые приложения компилируются без этого элемента в структуре LINEADDRESSCAPS и используют sizeOF(LINEADDRESSCAPS) меньше нового размера. Приложение передает параметр dwAPIVersion с функцией lineGetAddressCaps, которая может использоваться для указания TAPI при обработке этой ситуации. Если приложение передает член dwTotalSize меньше размера фиксированной части структуры, как определено в указанном элементе dwAPIVersion , возвращается LINEERR_STRUCTURETOOSMALL. Если приложение выделило достаточно памяти, перед вызовом TSPI_lineGetAddressCaps TAPI устанавливает для членов dwNeedededSize и dwUsedSize фиксированный размер структуры в том виде, в котором она существовала в указанной версии API.

Новые поставщики служб (которые поддерживают новую версию API) должны проверять переданную версию API. Если версия API меньше самой высокой версии, поддерживаемой поставщиком, поставщик услуг не должен заполнять поля, не поддерживаемые в более ранних версиях API, так как они будут находиться в переменной части старой структуры.

Новые приложения должны учитывать согласованную версию API, а не проверять содержимое полей в фиксированной части за пределами исходной части фиксированной части структуры для согласованной версии API.

Члены dwPredictiveAutoTransferStates через dwAvailableMediaModes доступны только для приложений, которые запрашивают API версии 2.0 или более поздней при вызове lineGetAddressCaps.