Поделиться через

OID_CO_TAPI_LINE_CAPS

  • Статья

OID OID_CO_TAPI_LINE_CAPS запрашивает диспетчер звонков или драйвер интегрированного диспетчера вызовов мини-порта (MCM) для возврата возможностей телефонии для указанной линии. Этот OID также запрашивает диспетчер вызовов или драйвер MCM, чтобы указать, имеют ли адреса в этой строке разнородные возможности телефонии.

Этот запрос использует структуру CO_TAPI_LINE_CAPS, определенную следующим образом, для запроса возможностей телефонии указанной строки:

typedef struct _CO_TAPI_LINE_CAPS {
    IN  ULONG           ulLineID;
    OUT ULONG           ulFlags;
    OUT LINE_DEV_CAPS   LineDevCaps;
} CO_TAPI_LINE_CAPS, *PCO_TAPI_LINE_CAPS;

Элементы этой структуры содержат следующие сведения:

ulLineID
Указывает строку, для которой должны быть возвращены возможности телефонии. ulLineID — это отсчитываемый от нуля идентификатор.

ulFlags
Если строка поддерживает несколько адресов с различными возможностями телефонии, диспетчер вызовов или драйвер MCM задает бит CO_TAPI_FLAG_PER_ADDRESS_CAPS в ulFlags; В противном случае диспетчер вызовов или драйвер MCM очищает этот бит. Все неопределенные биты зарезервированы и должны иметь значение 0.

LineDevCaps
Указывает возможности телефонии линии, отформатированные в виде LINE_DEV_CAPS структуры. Дополнительные сведения об этой структуре см. в Microsoft Windows SDK и файле заголовка ndistapi.h.

Комментарии

После запроса возможностей телефонии на устройстве диспетчера вызовов или драйвера MCM с помощью OID_CO_TAPI_CM_CAPS клиент, ориентированный на подключение, запрашивает возможности телефонии линий, поддерживаемых устройством.

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

Параметр ulFlags определяет, сколько раз клиент впоследствии запрашивает возможности адресов в строке:

  • Если строка поддерживает только один адрес или если строка поддерживает несколько адресов с одинаковыми возможностями адреса, клиент запрашивает OID_CO_TAPI_ADDRESS_CAPS один раз.
  • Если строка поддерживает несколько адресов с различными возможностями, клиент должен запросить OID_CO_TAPI_ADDRESS_CAPS один раз для каждого адреса в строке.

Требования

Версия: Windows Vista и более поздние заголовок: Ntddndis.h (включая Ndis.h)