TSPI_lineGetCallStatus函式 (tspi.h)
TSPI_lineGetCallStatus函式會傳回指定呼叫的目前狀態。
語法
LONG TSPIAPI TSPI_lineGetCallStatus(
HDRVCALL hdCall,
LPLINECALLSTATUS lpCallStatus
);
參數
hdCall
服務提供者對要查詢其狀態之呼叫的控制碼。 hdCall的撥號狀態可以是任何狀態。
lpCallStatus
LINECALLSTATUS類型的可變大小資料結構的指標。 此結構會填入通話狀態資訊。
傳回值
如果函式成功，則傳回零;如果發生錯誤，則傳回錯誤號碼。 可能的傳回值如下所示：
LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL LINEERR_OPERATIONUNAVAIL。
備註
下表指出服務提供者會填入 LINECALLSTATUS 資料結構的成員，以及 TAPI 填入哪些成員。 服務提供者必須保留 (不得覆寫 TAPI 填入的值) 。
| 成員名稱 | Tapi | 服務提供者 |
|---|---|---|
| dwTotalSize; | X | |
| dwNeededSize; | X | |
| dwUsedSize; | X | |
| dwCallState; | X | |
| dwCallStateMode; | X | |
| dwCallPrivilege; | X | |
| dwCallFeatures; | X | |
| dwDevSpecificSize; | X | |
| dwDevSpecificOffset; | X |
TSPI_lineGetCallStatus 會傳回呼叫的動態狀態，而 TSPI_lineGetCallInfo 主要會傳回有關呼叫的靜態資訊。 通話狀態資訊包括目前的通話狀態、當處於此狀態時與呼叫相關的詳細模式資訊， (如果有任何) ，以及呼叫處於此狀態時，可用的 TSPI 函式 TAPI 清單可以在呼叫上叫用。
需求
| 目標平台 | Windows |
| 標頭 | tspi.h |