OID_CO_TAPI_TRANSLATE_TAPI_CALLPARAMS

OID_CO_TAPI_TRANSLATE_TAPI_CALLPARAMS OID 请求呼叫管理器或集成呼叫管理器微型端口 (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
客户端必须在 ulFlags中设置CO_TAPI_FLAG_OUTGOING_CALL位。 客户端可以选择 ulFlags 中设置CO_TAPI_USE_DEFAULT_CALLPARAMS位,要求调用管理器或 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结构指定要转换为 NDIS 调用参数的 TAPI 调用参数。 有关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结构指定已转换给定 TAPI 调用参数的 NDIS 调用参数。

言论

如果请求成功,则调用管理器或 MCM 驱动程序会使用已转换的 NDIS 调用参数填充由 NdisCallParams 引用的CO_CALL_PARAMETERS结构。 调用管理器或 MCM 驱动程序必须在 NdisCallParams引用的平面内存部分中分配CO_CALL_PARAMETERS结构。 客户端将CO_CALL_PARAMETERS结构的总长度写入 NdisCallParams.Length

如果客户端在 ulFlags中设置CO_TAPI_USE_DEFAULT_CALLPARAMS位,则客户端不指定 TAPI 调用参数。 在这种情况下,调用管理器或 MCM 驱动程序应返回设备的默认 NDIS 调用参数。 如果设备没有默认的 NDIS 调用参数,则调用管理器或 MCM 驱动程序应返回NDIS_STATUS_FAILURE。

要求

版本:Windows Vista 及更高版本 标头:Ntddndis.h(包括 Ndis.h)