LINECALLSTATUS 结构 (tapi.h)

LINECALLSTATUS 结构描述调用的当前状态。 此结构中的信息取决于地址的设备功能、调用应用程序的调用所有权以及正在查询的呼叫的当前状态。 lineGetCallStatus 和 TSPI_lineGetCallStatus 函数返回 LINECALLSTATUS 结构。

语法

typedef struct linecallstatus_tag {
  DWORD      dwTotalSize;
  DWORD      dwNeededSize;
  DWORD      dwUsedSize;
  DWORD      dwCallState;
  DWORD      dwCallStateMode;
  DWORD      dwCallPrivilege;
  DWORD      dwCallFeatures;
  DWORD      dwDevSpecificSize;
  DWORD      dwDevSpecificOffset;
  DWORD      dwCallFeatures2;
#if ...
  SYSTEMTIME tStateEntryTime;
#else
  WORD       tStateEntryTime[8];
#endif
} LINECALLSTATUS, *LPLINECALLSTATUS;

成员

dwTotalSize

分配给此数据结构的总大小（以字节为单位）。

dwNeededSize

保存所有返回的信息所需的此数据结构的大小（以字节为单位）。

dwUsedSize

包含有用信息的此数据结构部分的大小（以字节为单位）。

dwCallState

使用 LINECALLSTATE_常量之一的调用的当前调用状态。

dwCallStateMode

dwCallStateMode 成员的解释依赖于调用状态。 在许多情况下，该值将为零。 下表显示了给定 dwCallState 值的 dwCallStateMode 类型。

dwCallState	含义
LINECALLSTATE_BUSY	LINEBUSYMODE_常量
LINECALLSTATE_CONNECTED	LINECONNECTEDMODE_常量
LINECALLSTATE_DIALTONE	LINEDIALTONEMODE_常量
LINECALLSTATE_DISCONNECTED	LINEDISCONNECTMODE_常量
LINECALLSTATE_OFFERING	LINEOFFERINGMODE_常量
LINECALLSTATE_SPECIALINFO	LINESPECIALINFO_常量

dwCallPrivilege

应用程序对此调用的特权。 此成员使用一个或多个 LINECALLPRIVILEGE_常量。

dwCallFeatures

指示可在调用时调用的电话 API 函数的标志，给定设备功能中功能的可用性、当前调用状态和调用应用程序的呼叫所有权。 零表示应用程序在其当前状态的调用上无法调用相应的功能;一个指示可以调用该功能。 此成员使用 LINECALLFEATURE_ 常量。

dwDevSpecificSize

设备特定字段的大小（以字节为单位）。

dwDevSpecificOffset

从结构开头到大小可变的设备特定字段的偏移量。 字段的大小由 dwDevSpecificOffset 指定。

dwCallFeatures2

指示可以在调用时调用其他函数，给定设备功能中的功能的可用性、当前调用状态和调用应用程序的调用所有权。 dwCallFeatures 成员的扩展。 此成员使用 常量LINECALLFEATURE2_。

tStateEntryTime

进入当前呼叫状态的协调世界时。

tStateEntryTime[8]

进入当前呼叫状态的协调世界时。

注解

特定于设备的扩展应使用 DevSpecific (dwDevSpecificSize 和 dwDevSpecificOffset) 此数据结构的可变大小区域。

每当调用的调用状态发生更改时，应用程序将发送 LINE_CALLSTATE 消息。 此消息仅提供呼叫的新呼叫状态。 有关呼叫的其他状态可用于 lineGetCallStatus。

成员 dwCallFeatures2 和 tStateEntryTime 仅适用于使用 API 版本 2.0 或更高版本打开线路设备的应用程序。

要求

要求	值
Header	tapi.h

另请参阅

LINEDIALPARAMS

LINE_CALLSTATE

TSPI_lineGetCallStatus

lineGetCallStatus