TSPI_lineGetCallInfo 函数 (tspi.h)

  • 项目

TSPI_lineGetCallInfo函数返回有关指定调用的详细信息。

语法

LONG TSPIAPI TSPI_lineGetCallInfo(
  HDRVCALL       hdCall,
  LPLINECALLINFO lpCallInfo
);

参数

hdCall

要检索其调用信息的调用的服务提供商句柄。 hdCall 的调用状态可以是任何状态。

lpCallInfo

指向 LINECALLINFO 类型的可变大小数据结构的指针。 成功完成请求后，此结构将填充与调用相关的信息。

返回值

如果函数成功，则返回零;如果发生错误，则返回错误号。 可能的返回值如下所示：

LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL、LINEERR_OPERATIONUNAVAIL。

注解

下表指示 TAPI 填充 LINECALLINFO 数据结构的哪些成员，以及服务提供商填充哪些成员。 服务提供商必须保留 (它不得覆盖 TAPI 填充的值) 。

成员名称 Tapi 服务提供商
dwTotalSize; X
dwNeededSize; X
dwUsedSize; X
hLine; X
dwLineDeviceID; X
dwAddressID; X
dwBearerMode; X
dwRate; X
dwMediaMode; X
dwAppSpecific; X
dwCallID; X
dwRelatedCallID; X
dwCallParamFlags; X
dwCallStates; X X
dwMonitorDigitModes; X
dwMonitorMediaModes; X
DialParams; X
dwOrigin; X
dwReason; X
dwCompletionID; X
dwNumOwners; X
dwNumMonitors; X
dwCountryCode; X
dwTrunk; X
dwCallerIDFlags; X
dwCallerIDSize; X
dwCallerIDOffset; X
dwCallerIDNameSize; X
dwCallerIDNameOffset; X
dwCalledIDFlags; X
dwCalledIDSize; X
dwCalledIDOffset; X
dwCalledIDNameSize; X
dwCalledIDNameOffset; X
dwConnectedIDFlags; X
dwConnectedIDSize; X
dwConnectedIDOffset; X
dwConnectedIDNameSize; X
dwConnectedIDNameOffset; X
dwRedirectionIDFlags; X
dwRedirectionIDSize; X
dwRedirectionIDOffset; X
dwRedirectionIDNameSize; X
dwRedirectionIDNameOffset; X
dwRedirectingIDFlags; X
dwRedirectingIDSize; X
dwRedirectingIDOffset; X
dwRedirectingIDNameSize; X
dwRedirectingIDNameOffset; X
dwAppNameSize; X
dwAppNameOffset; X
dwDisplayableAddressSize; X
dwDisplayableAddressOffset; X
dwCalledPartySize; X
dwCalledPartyOffset; X
dwCommentSize; X
dwCommentOffset; X
dwDisplaySize; X
dwDisplayOffset; X
dwUserUserInfoSize; X
dwUserUserInfoOffset; X
dwHighLevelCompSize; X
dwHighLevelCompOffset; X
dwLowLevelCompSize; X
dwLowLevelCompOffset; X
dwChargingInfoSize; X
dwChargingInfoOffset; X
dwTerminalModesSize; X
dwTerminalModesOffset; X
dwDevSpecificSize; X
dwDevSpecificOffset; X
 

TAPI 填充 dwAppNameSize/Offset、 dwCalledPartySize/Offset 和 dwCommentSize/Offset 成员的大小和偏移字段，并在调用服务提供商后更新 dwUsedSize 中的值以反映这些值。

服务提供商从 TSPI_lineGetCallInfo 函数返回后，TAPI 将设置 LINECALLINFO 结构的 dwCallStates 成员，如下所示：

LINECALLINFO.dwCallStates |= LINECALLSTATE_UNKNOWN;

如果服务提供商将线路建模为通道资源的“池”，并针对多个地址标识符对调用进行反向多路复用，则它应始终选择其中一个地址标识符作为 LINECALLINFO 数据结构中此函数报告的主要标识符。

要求

要求 值
目标平台 Windows
标头 tspi.h