LINECALLPARAMS 结构 (tapi.h)
LINECALLPARAMS 结构描述在使用 lineMakeCall 和 TSPI_lineMakeCall 函数进行调用时提供的参数。 LINECALLPARAMS 结构还用作其他操作（如 lineOpen 函数）中的参数。
语法块右侧的注释指示未将此结构提供给 lineMakeCall 时使用的默认值。
语法
typedef struct linecallparams_tag {
DWORD dwTotalSize;
DWORD dwBearerMode;
DWORD dwMinRate;
DWORD dwMaxRate;
DWORD dwMediaMode;
DWORD dwCallParamFlags;
DWORD dwAddressMode;
DWORD dwAddressID;
LINEDIALPARAMS DialParams;
DWORD dwOrigAddressSize;
DWORD dwOrigAddressOffset;
DWORD dwDisplayableAddressSize;
DWORD dwDisplayableAddressOffset;
DWORD dwCalledPartySize;
DWORD dwCalledPartyOffset;
DWORD dwCommentSize;
DWORD dwCommentOffset;
DWORD dwUserUserInfoSize;
DWORD dwUserUserInfoOffset;
DWORD dwHighLevelCompSize;
DWORD dwHighLevelCompOffset;
DWORD dwLowLevelCompSize;
DWORD dwLowLevelCompOffset;
DWORD dwDevSpecificSize;
DWORD dwDevSpecificOffset;
DWORD dwPredictiveAutoTransferStates;
DWORD dwTargetAddressSize;
DWORD dwTargetAddressOffset;
DWORD dwSendingFlowspecSize;
DWORD dwSendingFlowspecOffset;
DWORD dwReceivingFlowspecSize;
DWORD dwReceivingFlowspecOffset;
DWORD dwDeviceClassSize;
DWORD dwDeviceClassOffset;
DWORD dwDeviceConfigSize;
DWORD dwDeviceConfigOffset;
DWORD dwCallDataSize;
DWORD dwCallDataOffset;
DWORD dwNoAnswerTimeout;
DWORD dwCallingPartyIDSize;
DWORD dwCallingPartyIDOffset;
DWORD dwAddressType;
} LINECALLPARAMS, *LPLINECALLPARAMS;
成员
dwTotalSize
分配给此数据结构的总大小（以字节为单位）。 此大小应足够大，以容纳此数据结构的所有固定和可变大小部分。
dwBearerMode
调用的持有者模式。 此成员使用 LINEBEARERMODE_常量之一。
如果 dwBearerMode 为零，则默认值为 LINEBEARERMODE_VOICE。
dwMinRate
为调用的数据流请求的最小数据速率，以 bps (位/秒) 。
dwMaxRate
为调用的数据流请求的最大数据速率，以 bps (位/秒) 。 进行调用时，服务提供商会尝试在请求的范围内提供最高可用速率， (dwMinRate 到 dwMaxRate) 。 如果需要特定的数据速率，则应将 dwMinRate 和 dwMaxRate 设置为该值。 如果应用程序在一个速率下效果最佳，但能够降低到较低的速率，则应用程序应分别将这些速率指定为最大值和最小速率。 如果 dwMaxRate 为零，则默认值由 LINEDEVCAPS 结构的 dwMaxRate 成员指定。 这是设备支持的最大速率。
dwMediaMode
呼叫的预期媒体类型。 此成员使用 LINEMEDIAMODE_常量之一。
如果 dwMediaMode 为零，则默认值为 LINEMEDIAMODE_INTERACTIVEVOICE。
dwCallParamFlags
布尔调用设置参数的集合。 此成员使用一个或多个 LINECALLPARAMFLAGS_常量。
dwAddressMode
指定源地址的模式。 此成员使用 LINEADDRESSMODE_常量之一。
dwAddressID
如果 dwAddressMode 设置为 LINEADDRESSMODE_ADDRESSID，则原始地址的地址标识符。 地址标识符与地址永久关联;标识符在操作系统升级中保持不变。
DialParams
要在此调用中使用的拨号参数，类型为 LINEDIALPARAMS。 当为此字段指定值 0 时，将使用字段的默认值，如 LINEDEVCAPS 结构的 DefaultDialParams 成员所示。 如果为 LINEDEVCAPS 结构中 MinDialParams 和 MaxDialParams 中的相应字段指定的范围之外的字段指定了非零值，则改用有效范围内最接近的值。
dwOrigAddressSize
原始地址字段的大小（以字节为单位）。
dwOrigAddressOffset
从结构开头到保存原始地址的可变大小的字段的偏移量。 此地址的格式取决于 dwAddressMode 成员。 字段的大小由 dwOrigAddressSize 指定。
dwDisplayableAddressSize
可显示字符串的大小，包括 null 终止符（以字节为单位）。
dwDisplayableAddressOffset
用于日志记录的可显示字符串。 这些成员的内容记录在调用的 LINECALLINFO 消息的 dwDisplayableAddressOffset 和 dwDisplayableAddressSize 成员中。 lineTranslateAddress 函数返回要放置在 LINETRANSLATEOUTPUT 结构的 dwDisplayableAddressSize 和 dwDisplayableAddressOffset 成员的此字段中的适当信息。 字段的大小由 dwDisplayableAddressSize 指定。
dwCalledPartySize
被调用方信息的大小（以字节为单位）。
dwCalledPartyOffset
从 结构的开头到保存被调用方信息的可变大小的字段的偏移量。 此信息可由进行调用的应用程序指定，并在调用的信息结构中用于日志记录。 此字段的格式为 dwStringFormat 的格式，如 LINEDEVCAPS 中所述。 字段的大小由 dwCalledPartySize 指定。
dwCommentSize
呼叫注释字段的大小（以字节为单位）。
dwCommentOffset
从 结构的开头到包含有关调用的注释的可变大小字段的偏移量。 此信息可由进行调用的应用程序指定，并在调用的信息结构中用于日志记录。 此字段的格式为 dwStringFormat 的格式，如 LINEDEVCAPS 中所述。 字段的大小由 dwCommentSize 指定。
dwUserUserInfoSize
用户信息（包括 null 终止符）的大小（以字节为单位）。
dwUserUserInfoOffset
从结构的开头到保存用户-用户信息的可变大小的字段的偏移量。 用户-用户信息的协议鉴别器字段（如果需要）应显示为 dwUserUserInfoOffset 指向的数据的第一个字节，并且必须在 dwUserUserInfoSize 中考虑。
dwHighLevelCompSize
高级兼容性信息的大小（以字节为单位）。
dwHighLevelCompOffset
从结构开头到保存高级兼容性信息的可变大小字段的偏移量。 字段的大小由 dwHighLevelCompSize 指定。
dwLowLevelCompSize
低级别兼容性信息的大小（以字节为单位）。
dwLowLevelCompOffset
从 结构开头到保存低级别兼容性信息的可变大小字段的偏移量。 字段的大小由 dwLowLevelCompSize 指定。
dwDevSpecificSize
设备特定信息的大小（以字节为单位）。
dwDevSpecificOffset
从结构开头到保存设备特定信息的可变大小的字段的偏移量。 字段的大小由 dwDevSpecificSize 指定。
dwPredictiveAutoTransferStates
LINECALLSTATE_常量，其中的条目会导致调用被盲目传输到指定的目标地址。 如果不需要自动传输，则设置为零。
dwTargetAddressSize
包括 null 终止符的目标可拨号地址字符串的大小（以字节为单位）。
dwTargetAddressOffset
从 结构的开头偏移到指定目标可拨号地址的字符串 (不是 dwAddressID) ;在某些自动操作的情况下使用。 对于预测拨号， 指定呼叫应自动转移到的地址。 字符串的大小由 dwTargetAddressSize 指定。
这实质上是未使用自动传输时传递给 lineBlindTransfer 的同一字符串。 如果不需要自动传输，则设置为零。 对于“不举行会议”，指定应与呼叫开会的地址。 对于一步转移，指定要在咨询呼叫上拨打的地址。
dwSendingFlowspecSize
服务质量信息的大小（以字节为单位）。
dwSendingFlowspecOffset
从结构开头到 FLOWSPEC 结构的偏移量，后跟 WinSock 提供程序特定的数据，相当于 QOS 结构中在 SendingFlowspec 中存储的数据。 指定呼叫的发送方向上所需的服务质量。 FLOWSPEC 结构后面的提供程序特定部分不得包含指向其他内存块的指针，因为 TAPI 不知道如何封送专用指针 () 所指向的数据，并通过进程间通信将其传递给应用程序。 字段的大小由 dwSendingFlowspecSize 指定。
dwReceivingFlowspecSize
服务质量信息的大小（以字节为单位）。
dwReceivingFlowspecOffset
从结构开头到 FLOWSPEC 结构的偏移量，后跟 WinSock 提供程序特定的数据，相当于 QOS 结构中在 ReceivingFlowspec 中存储的数据。 指定呼叫的接收方向上所需的服务质量。 FLOWSPEC 结构后面的提供程序特定部分不得包含指向其他内存块的指针，因为 TAPI 不知道如何封送专用指针 () 所指向的数据，并通过进程间通信将其传递给应用程序。 字段的大小由 dwReceivingFlowspecSize 指定。
dwDeviceClassSize
设备类字符串的大小（包括 null 终止符），以字节为单位。
dwDeviceClassOffset
从 结构的开头偏移到以 null 结尾的字符串，该字符串指示其配置在 DeviceConfig 中指定的设备的设备类。 有效的设备类字符串与为 lineGetID 函数指定的设备类字符串相同。 字符串的大小由 dwDeviceClassSize 指定。
dwDeviceConfigSize
设备配置数据的大小（以字节为单位）。
dwDeviceConfigOffset
从结构开头到不透明配置数据结构的偏移量。 此值在 lineGetDevConfig 返回的 VARSTRING 结构中的 dwStringSize 成员中返回。 如果大小为零，则使用默认设备配置。 这允许应用程序在启动调用之前设置设备配置。 字段的大小由 dwDeviceConfigSize 指定。
dwCallDataSize
应用程序可设置的调用数据的大小（以字节为单位）。
dwCallDataOffset
从 结构开头到最初附加到调用的应用程序可设置的调用数据的偏移量。 字段的大小由 dwCallDataSize 指定。
dwNoAnswerTimeout
拨号完成后，应允许呼叫在 PROCEEDING 或 RINGBACK 状态中等待的秒数，然后服务提供商使用LINECALLSTATE_DISCONNECTED和LINEDISCONNECTMODE_NOANSWER自动放弃呼叫。 值为 0 表示应用程序不需要自动放弃调用。
dwCallingPartyIDSize
包括 null 终止符（以字节为单位）的调用方 ID 字符串的大小，包括 null 终止符。
dwCallingPartyIDOffset
从结构的开头偏移到以 null 结尾的字符串，该字符串指定发出调用的一方的身份。 如果标识符的内容是可接受的，并且路径可用，则服务提供商会将标识符传递给被调用方，以指示调用方的身份。 字段的大小由 dwCallingPartyIDSize 指定。
dwAddressType
用于呼叫的地址类型。 仅当协商的 TAPI 版本为 3.0 或更高版本时，结构中的此成员才可用。
注解
特定于设备的扩展应使用 DevSpecific (dwDevSpecificSize 和 dwDevSpecificOffset) 此数据结构的可变大小区域。
设置调用时，此结构用作 lineMakeCall 的参数。 其字段允许应用程序指定从网络请求的服务质量以及各种 ISDN 调用设置参数。 如果未向 lineMakeCall 提供 LINECALLPARAMS 结构，则会使用上面列出的默认值请求默认 POTS 语音级呼叫。
要求
| 标头 | tapi.h |