TSPI_lineGetLineDevStatus函数 (tspi.h)

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

另请参阅

LINEDEVSTATUS

TSPI_lineGetAddressStatus