LINEDEVSTATUS 结构 (tapi.h)

项目
08/26/2023

LINEDEVSTATUS 结构描述线路设备的当前状态。 lineGetLineDevStatus 函数和 TSPI_lineGetLineDevStatus 函数返回 LINEDEVSTATUS 结构。

语法

typedef struct linedevstatus_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwNumOpens;
  DWORD dwOpenMediaModes;
  DWORD dwNumActiveCalls;
  DWORD dwNumOnHoldCalls;
  DWORD dwNumOnHoldPendCalls;
  DWORD dwLineFeatures;
  DWORD dwNumCallCompletions;
  DWORD dwRingMode;
  DWORD dwSignalLevel;
  DWORD dwBatteryLevel;
  DWORD dwRoamMode;
  DWORD dwDevStatusFlags;
  DWORD dwTerminalModesSize;
  DWORD dwTerminalModesOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
  DWORD dwAvailableMediaModes;
  DWORD dwAppInfoSize;
  DWORD dwAppInfoOffset;
} LINEDEVSTATUS, *LPLINEDEVSTATUS;

成员

dwTotalSize

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

dwNeededSize

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

dwUsedSize

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

dwNumOpens

在线路设备上打开的活动数。

dwOpenMediaModes

指示线路设备当前打开的媒体类型的位数组。

dwNumActiveCalls

调用状态为 idle、onhold、onholdpendingtransfer 和 onholdpendingconference 之外的线路上的调用数。

dwNumOnHoldCalls

处于保留状态的行上的调用数。

dwNumOnHoldPendCalls

处于 onholdpendingtransfer 或 onholdpendingconference 状态的行上的调用数。

dwLineFeatures

此行中当前可用的行相关函数。此成员使用一个或多个 LINEFEATURE_常量。

dwNumCallCompletions

行上未完成的呼叫完成请求数。

dwRingMode

线路设备上的当前环形模式。

dwSignalLevel

线路上连接的当前信号级别。这是0x00000000 (最弱信号) 到最强信号) 0x0000FFFF (范围内的值。

dwBatteryLevel

线路设备硬件的当前电池电量。这是0x00000000 (电池空) 到0x0000FFFF (电池充满) 范围内的值。

dwRoamMode

线路设备的当前漫游模式。此成员使用 LINEROAMMODE_常量之一。

dwDevStatusFlags

指示状态信息的标志，例如设备是否已锁定。它由 LINEDEVSTATUSFLAGS_常量中的一个或多个成员组成。

dwTerminalModesSize

包含当前终端模式数组的可变大小设备字段的大小（以字节为单位）。

dwTerminalModesOffset

从结构的开头到当前终端模式数组的偏移量（以字节为单位）。此数组按终端 ID 编制索引，范围从零到 dwNumTerminals 减 1。数组中的每个条目使用此行的 lineSetTerminal 函数指定相应终端集的当前终端模式。每个条目都是一个 DWORD ，指定一个或多个 LINETERMMODE_常量。数组的大小由 dwTerminalModesSize 指定。

dwDevSpecificSize

大小可变的设备特定字段的大小（以字节为单位）。如果特定于设备的信息是指向字符串的指针，则大小必须包含 null 终止符。

dwDevSpecificOffset

从结构开头到特定于设备的字段的偏移量（以字节为单位）。字段的大小由 dwDevSpecificSize 指定。

dwAvailableMediaModes

指示当 dwLineFeatures 成员指示可以进行新调用时，可在此线路设备上创建的新调用上调用的媒体类型。如果此成员为零，则表示服务提供商不知道或无法指示哪些媒体类型可用，在这种情况下，LINEDEVCAPS 的 dwMediaModes 成员中指示的任何或所有媒体类型都可能可用。

dwAppInfoSize

标识已打开行的应用程序的数组的大小（以字节为单位）。

dwAppInfoOffset

从结构的开头偏移到 LINEAPPINFO 结构的数组。 dwNumOpens 成员指示数组中的元素数。数组中的每个元素都标识一个打开行的应用程序。数组的大小由 dwAppInfoSize 指定。