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。
備註
下表指出 TAPI 填入 LINEDEVSTATUS 數據結構的成員，以及服務提供者所填入的成員。 服務提供者必須保留 (它不得覆寫) 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 |