TSPI_lineGetLineDevStatus函数查询指定的开行设备的当前状态。 返回的信息是行上所有地址的全局信息。
语法
LONG TSPIAPI TSPI_lineGetLineDevStatus(
HDRVLINE hdLine,
LPLINEDEVSTATUS lpLineDevStatus
);
参数
hdLine
要查询的行的服务提供商句柄。
lpLineDevStatus
指向 LINEDEVSTATUS 类型的可变大小数据结构的指针。 此结构填充了线路的设备状态。
返回值
如果函数成功，则返回零;如果发生错误，则返回错误号。 可能的返回值如下所示：
LINEERR_INVALLINEHANDLE、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL、LINEERR_OPERATIONUNAVAIL。
注解
下表指示了哪些 LINEDEVSTATUS 数据结构的成员由 TAPI 填充，哪些成员由服务提供商填充。 服务提供商必须保留 (它不得覆盖 TAPI 填充的值) 。
| 成员名称 | Tapi | 服务提供商 |
|---|---|---|
| dwTotalSize; | X | |
| dwNeededSize; | X | |
| dwUsedSize; | X | |
| dwNumOpens; | X | |
| dwOpenMediaModes; | X | |
| dwNumActiveCalls; | X | |
| dwNumOnHoldCalls; | X | |
| dwNumOnHoldPendCalls; | X | |
| dwLineFeatures; | X | |
| dwNumCallCompletions; | X | |
| dwRingMode; | X | |
| dwSignalLevel; | X | |
| dwBatteryLevel; | X | |
| dwRoamMode; | X | |
| dwDevStatusFlags; | X | |
| dwTerminalModesSize; | X | |
| dwTerminalModesOffset; | X | |
| dwDevSpecificSize; | X | |
| dwDevSpecificOffset; | X |
要求
| 要求 | 值 |
|---|---|
| 目标平台 | Windows |
| 标头 | tspi.h |