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

OID_CO_TAPI_TRANSLATE_TAPI_CALLPARAMS

  • Статья

OID OID_CO_TAPI_TRANSLATE_TAPI_CALLPARAMS запрашивает диспетчер вызовов или драйвер минипорта интегрированного диспетчера вызовов (MCM) для преобразования параметров вызова TAPI в параметры вызова NDIS. Клиент, запрашивающий этот OID, использует возвращенные параметры вызова NDIS в качестве входных данных (отформатированных как структура CO_CALL_PARAMETERS ) в NdisClMakeCall, с помощью которого клиент выполняет исходящий вызов.

Этот OID использует структуру CO_TAPI_TRANSLATE_TAPI_CALLPARAMS, которая определяется следующим образом:

typedef struct _CO_TAPI_TRANSLATE_TAPI_CALLPARAMS {
    IN  ULONG               ulLineID;
    IN  ULONG               ulAddressID;
    IN  ULONG               ulFlags;
    IN  NDIS_VAR_DATA_DESC  DestAddress;
    IN  NDIS_VAR_DATA_DESC  LineCallParams;
    OUT NDIS_VAR_DATA_DESC  NdisCallParams;
} CO_TAPI_TRANSLATE_TAPI_CALLPARAMS, *PCO_TAPI_TRANSLATE_TAPI_CALLPARAMS;

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

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

ulAddressID
Указывает отсчитываемый от нуля идентификатор адреса (в строке, заданной ulLineID), на который будет направлен исходящий вызов.

ulFlags
Клиент должен задать бит CO_TAPI_FLAG_OUTGOING_CALL в ulFlags. При необходимости клиент может задать бит CO_TAPI_USE_DEFAULT_CALLPARAMS в ulFlags , чтобы требовать от диспетчера вызовов или драйвера MCM игнорировать LineCallParams и возвращать параметры вызова NDIS по умолчанию для устройства.

DestAddress
Задает структуру NDIS_VAR_DATA_DESC , содержащую смещение от начала структуры NDIS_VAR_DATA_DESC до адреса назначения, отформатированного в виде массива символов. Структура NDIS_VAR_DATA_DESC также содержит длину адреса назначения. Адрес назначения — это адрес, на который будет направлен исходящий звонок.

LineCallParams
Указывает структуру NDIS_VAR_DATA_DESC , содержащую смещение от начала структуры NDIS_VAR_DATA_DESC к LINE_CALL_PARAMS структуре. Структура NDIS_VAR_DATA_DESC также содержит длину структуры LINE_CALL_PARAMS. Структура LINE_CALL_PARAMS указывает параметры вызова TAPI для преобразования в параметры вызова NDIS. Дополнительные сведения о структуре LINE_CALL_PARAMS см. в Microsoft Windows SDK и файле заголовка ndistapi.h.

NdisCallParams
Задает структуру NDIS_VAR_DATA_DESC , которая содержит смещение от начала структуры NDIS_VAR_DATA_DESC до структуры CO_CALL_PARAMETERS. Структура NDIS_VAR_DATA_DESC также содержит длину структуры CO_CALL_PARAMETERS . Структура CO_CALL_PARAMETERS указывает параметры вызова NDIS, в которые были переведены заданные параметры вызова TAPI.

Комментарии

Если запрос выполнен успешно, диспетчер вызовов или драйвер MCM заполняет структуру CO_CALL_PARAMETERS, на которую ссылается NdisCallParams , переведенными параметрами вызова NDIS. Диспетчер вызовов или драйвер MCM должны выделить структуру CO_CALL_PARAMETERS в неструктурированном разделе памяти, на который ссылается NdisCallParams. Клиент записывает общую длину структуры CO_CALL_PARAMETERS в NdisCallParams.Length.

Если клиент задает бит CO_TAPI_USE_DEFAULT_CALLPARAMS в ulFlags, клиент не задает параметры вызова TAPI. В этом случае диспетчер вызовов или драйвер MCM должны возвращать параметры вызова NDIS по умолчанию для устройства. Если для устройства отсутствуют параметры вызова NDIS по умолчанию, диспетчер вызовов или драйвер MCM должны вернуть NDIS_STATUS_FAILURE.

Требования

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