TSPI_lineGetCallInfo函式 (tspi.h)
TSPI_lineGetCallInfo函式會傳回所指定呼叫的詳細資訊。
語法
LONG TSPIAPI TSPI_lineGetCallInfo(
HDRVCALL hdCall,
LPLINECALLINFO lpCallInfo
);
參數
hdCall
服務提供者要擷取其呼叫資訊的呼叫句柄。 hdCall 的呼叫狀態可以是任何狀態。
lpCallInfo
LINECALLINFO 類型的可變大小數據結構的指標。 成功完成要求時，此結構會填入呼叫相關信息。
傳回值
如果函式成功或發生錯誤，則傳回零。 可能的傳回值如下所示：
LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL LINEERR_OPERATIONUNAVAIL。
備註
下表指出 TAPI 填入 LINECALLINFO 數據結構的成員，以及服務提供者填入哪些成員。 服務提供者必須保留 (它不得覆寫) TAPI 填入的值。
| 成員名稱 | Tapi | 服務提供者 |
|---|---|---|
| dwTotalSize; | X | |
| dwNeededSize; | X | |
| dwUsedSize; | X | |
| hLine; | X | |
| dwLineDeviceID; | X | |
| dwAddressID; | X | |
| dwBearerMode; | X | |
| dwRate; | X | |
| dwMediaMode; | X | |
| dwAppSpecific; | X | |
| dwCallID; | X | |
| dwRelatedCallID; | X | |
| dwCallParamFlags; | X | |
| dwCallStates; | X | X |
| dwMonitorDigitModes; | X | |
| dwMonitorMediaModes; | X | |
| DialParams; | X | |
| dwOrigin; | X | |
| dwReason; | X | |
| dwCompletionID; | X | |
| dwNumOwners; | X | |
| dwNumMonitors; | X | |
| dwCountryCode; | X | |
| dwTrunk; | X | |
| dwCallerIDFlags; | X | |
| dwCallerIDSize; | X | |
| dwCallerIDOffset; | X | |
| dwCallerIDNameSize; | X | |
| dwCallerIDNameOffset; | X | |
| dwCalledIDFlags; | X | |
| dwCalledIDSize; | X | |
| dwCalledIDOffset; | X | |
| dwCalledIDNameSize; | X | |
| dwCalledIDNameOffset; | X | |
| dwConnectedIDFlags; | X | |
| dwConnectedIDSize; | X | |
| dwConnectedIDOffset; | X | |
| dwConnectedIDNameSize; | X | |
| dwConnectedIDNameOffset; | X | |
| dwRedirectionIDFlags; | X | |
| dwRedirectionIDSize; | X | |
| dwRedirectionIDOffset; | X | |
| dwRedirectionIDNameSize; | X | |
| dwRedirectionIDNameOffset; | X | |
| dwRedirectingIDFlags; | X | |
| dwRedirectingIDSize; | X | |
| dwRedirectingIDOffset; | X | |
| dwRedirectingIDNameSize; | X | |
| dwRedirectingIDNameOffset; | X | |
| dwAppNameSize; | X | |
| dwAppNameOffset; | X | |
| dwDisplayableAddressSize; | X | |
| dwDisplayableAddressOffset; | X | |
| dwCalledPartySize; | X | |
| dwCalledPartyOffset; | X | |
| dwCommentSize; | X | |
| dwCommentOffset; | X | |
| dwDisplaySize; | X | |
| dwDisplayOffset; | X | |
| dwUserUserInfoSize; | X | |
| dwUserUserInfoOffset; | X | |
| dwHighLevelCompSize; | X | |
| dwHighLevelCompOffset; | X | |
| dwLowLevelCompSize; | X | |
| dwLowLevelCompOffset; | X | |
| dwChargingInfoSize; | X | |
| dwChargingInfoOffset; | X | |
| dwTerminalModesSize; | X | |
| dwTerminalModesOffset; | X | |
| dwDevSpecificSize; | X | |
| dwDevSpecificOffset; | X |
TAPI 會填入 dwAppNameSize/Offset、 dwCalledPartySize/Offset 和 dwCommentSize/Offset 成員的大小和位移字段，並更新 dwUsedSize 中的值，以在呼叫服務提供者之後反映這些值。
在服務提供者從 TSPI_lineGetCallInfo 函式傳回之後，TAPI 會設定 LINECALLINFO 結構的 dwCallStates 成員，如下所示：
LINECALLINFO.dwCallStates |= LINECALLSTATE_UNKNOWN;
如果服務提供者將線路模型化為通道資源的「集區」，並透過數個位址標識元執行反向多任務呼叫，它應該一致地選擇其中一個位址標識碼作為 LINECALLINFO 數據結構中此函式所報告的主要標識碼。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | tspi.h |