LINECALLPARAMS 結構 (tapi.h)
LINECALLPARAMS 結構描述使用lineMakeCall和 TSPI_lineMakeCall函式進行呼叫時所提供的參數。 LINECALLPARAMS 結構也會當做其他作業中的參數使用，例如lineOpen函式。
語法區塊右邊的批注表示未提供此結構給 lineMakeCall時所使用的預設值。
語法
typedef struct linecallparams_tag {
DWORD dwTotalSize;
DWORD dwBearerMode;
DWORD dwMinRate;
DWORD dwMaxRate;
DWORD dwMediaMode;
DWORD dwCallParamFlags;
DWORD dwAddressMode;
DWORD dwAddressID;
LINEDIALPARAMS DialParams;
DWORD dwOrigAddressSize;
DWORD dwOrigAddressOffset;
DWORD dwDisplayableAddressSize;
DWORD dwDisplayableAddressOffset;
DWORD dwCalledPartySize;
DWORD dwCalledPartyOffset;
DWORD dwCommentSize;
DWORD dwCommentOffset;
DWORD dwUserUserInfoSize;
DWORD dwUserUserInfoOffset;
DWORD dwHighLevelCompSize;
DWORD dwHighLevelCompOffset;
DWORD dwLowLevelCompSize;
DWORD dwLowLevelCompOffset;
DWORD dwDevSpecificSize;
DWORD dwDevSpecificOffset;
DWORD dwPredictiveAutoTransferStates;
DWORD dwTargetAddressSize;
DWORD dwTargetAddressOffset;
DWORD dwSendingFlowspecSize;
DWORD dwSendingFlowspecOffset;
DWORD dwReceivingFlowspecSize;
DWORD dwReceivingFlowspecOffset;
DWORD dwDeviceClassSize;
DWORD dwDeviceClassOffset;
DWORD dwDeviceConfigSize;
DWORD dwDeviceConfigOffset;
DWORD dwCallDataSize;
DWORD dwCallDataOffset;
DWORD dwNoAnswerTimeout;
DWORD dwCallingPartyIDSize;
DWORD dwCallingPartyIDOffset;
DWORD dwAddressType;
} LINECALLPARAMS, *LPLINECALLPARAMS;
成員
dwTotalSize
配置給這個數據結構的大小總計，以位元組為單位。 此大小應該夠大，足以保存此數據結構的所有固定大小和可變大小部分。
dwBearerMode
呼叫的持有人模式。 此成員會使用其中一個 LINEBEARERMODE_常數。
如果 dwBearerMode 為零，預設值會LINEBEARERMODE_VOICE。
dwMinRate
呼叫數據流所要求的最小數據速率，以 bps 每秒 (位) 。
dwMaxRate
呼叫數據流所要求的數據速率上限，以 bps 每秒 (位) 。 呼叫時，服務提供者會嘗試在要求的範圍中提供最高可用速率， (dwMinRate 至 dwMaxRate) 。 如果需要特定數據速率， dwMinRate 和 dwMaxRate 都應該設定為該值。 如果應用程式最適合使用一個速率，但能夠降低為較低的速率，則應用程式應該分別將這些專案指定為最大值和最小速率。 如果 dwMaxRate 是零，則預設值是由 LINEDEVCAPS 結構的 dwMaxRate 成員所指定。 這是裝置所支援的最大速率。
dwMediaMode
呼叫的預期媒體類型。 此成員會使用其中一個 LINEMEDIAMODE_常數。
如果 dwMediaMode 為零，則預設值為 LINEMEDIAMODE_INTERACTIVEVOICE。
dwCallParamFlags
布爾值呼叫設定參數的集合。 此成員會使用一或多個 LINECALLPARAMFLAGS_常數。
dwAddressMode
指定原始位址的模式。 此成員會使用其中一個 LINEADDRESSMODE_常數。
dwAddressID
如果 dwAddressMode 設定為 LINEADDRESSMODE_ADDRESSID，則來源地址的地址識別符。 位址標識符永久與地址相關聯;標識碼在操作系統升級之間維持不變。
DialParams
要在此呼叫上使用的撥號參數，類型為 LINEDIALPARAMS。 指定此欄位的值為 0 時，欄位的預設值會如 LINEDEVCAPS 結構的 DefaultDialParams 成員所示使用。 如果針對在LINEDEVCAPS結構中MinDialParams和 MaxDialParams中對應欄位所指定的範圍以外的欄位指定非零值，則會改用有效範圍內的最接近值。
dwOrigAddressSize
原始位址欄位的大小，以位元組為單位。
dwOrigAddressOffset
從結構開頭位移到保留原始位址的可變大小欄位。 此位址的格式取決於 dwAddressMode 成員。 欄位的大小是由 dwOrigAddressSize 所指定。
dwDisplayableAddressSize
可顯示字串的大小，包括 null 終止符，以位元組為單位。
dwDisplayableAddressOffset
用於記錄用途的可顯示字串。 這些成員的內容會記錄在呼叫之 LINECALLINFO 訊息的 dwDisplayableAddressOffset 和 dwDisplayableAddressSize 成員中。 lineTranslateAddress 函式會傳回要放置在 LINETRANSLATEOUTPUT 結構的 dwDisplayableAddressSize 和 dwDisplayableAddressOffset 成員中的適當資訊。 欄位的大小是由 dwDisplayableAddressSize 所指定。
dwCalledPartySize
呼叫方資訊的大小，以位元組為單位。
dwCalledPartyOffset
從結構的開頭位移到保留呼叫方資訊的可變大小欄位。 這項資訊可由進行呼叫的應用程式指定，並在呼叫的信息結構中提供以供記錄之用。 此欄位的格式是 dwStringFormat，如 LINEDEVCAPS 中所指定。 欄位的大小是由 dwCalledPartySize 所指定。
dwCommentSize
呼叫批注欄位的大小，以位元組為單位。
dwCommentOffset
從結構的開頭位移到保留有關呼叫之批注的可變大小字段。 這項資訊可由進行呼叫的應用程式指定，並在呼叫的信息結構中提供以供記錄之用。 此欄位的格式是 dwStringFormat，如 LINEDEVCAPS 中所指定。 欄位的大小是由 dwCommentSize 所指定。
dwUserUserInfoSize
用戶使用者資訊的大小，包括 null 終止符，以位元組為單位。
dwUserUserInfoOffset
從結構的開頭位移到保留用戶使用者資訊的可變大小欄位。 如有需要，使用者資訊的通訊協議辨別子位元段應該顯示為 dwUserUserInfoOffset 所指向之數據的第一個字節，而且必須在 dwUserUserUserInfoSize 中考慮。
dwHighLevelCompSize
高階相容性資訊的大小，以位元組為單位。
dwHighLevelCompOffset
從結構開頭位移至保留高階相容性資訊的可變大小字段。 欄位的大小是由 dwHighLevelCompSize 所指定。
dwLowLevelCompSize
低階相容性資訊的大小，以位元組為單位。
dwLowLevelCompOffset
從結構開頭位移至保留低階相容性資訊的可變大小字段。 欄位的大小是由 dwLowLevelCompSize 所指定。
dwDevSpecificSize
裝置特定資訊的大小，以位元組為單位。
dwDevSpecificOffset
從結構的開頭位移到保留裝置特定資訊的可變大小欄位。 欄位的大小是由 dwDevSpecificSize 所指定。
dwPredictiveAutoTransferStates
LINECALLSTATE_常數，進入會導致呼叫被盲目傳輸至指定的目標位址。 如果不需要自動傳輸，請將 設定為零。
dwTargetAddressSize
以位元組為單位的目標可撥號位址字串大小，包括 Null 終止符。
dwTargetAddressOffset
從結構的開頭位移到指定目標可撥號位址的字串， (不是 dwAddressID) ;在特定自動動作的情況下使用。 在預測撥號的情況下，指定應該自動轉移呼叫的位址。 字串的大小是由 dwTargetAddressSize 所指定。
這基本上與未使用自動傳輸時傳遞至 lineBlindTransfer 的字串相同。 如果不需要自動傳輸，請將 設定為零。 在無保留會議的情況下，指定應會議到通話的位址。 在單一步驟轉移的情況下，指定要在諮詢電話上撥打的位址。
dwSendingFlowspecSize
服務品質資訊的大小，以位元組為單位。
dwSendingFlowspecOffset
從結構的開頭位移至 FLOWSPEC 結構，後面接著 WinSock 提供者特定數據，相當於 QOS 結構中將儲存在 SendingFlowspec 中的專案。 指定呼叫上傳送方向所需的服務品質。 FLOWSPEC 結構後面的提供者特定部分不得包含其他記憶體區塊的指標，因為TAPI不知道如何封送處理私人指標所指向的數據， () ，並透過進程間通訊與應用程式傳達。 欄位的大小是由 dwSendingFlowspecSize 所指定。
dwReceivingFlowspecSize
服務品質資訊的大小，以位元組為單位。
dwReceivingFlowspecOffset
從結構的開頭位移至 FLOWSPEC 結構，後面接著 WinSock 提供者特定數據，相當於 QOS 結構中儲存在 ReceivingFlowspec 中的專案。 指定在呼叫的接收方向中所需的服務品質。 FLOWSPEC 結構後面的提供者特定部分不得包含其他記憶體區塊的指標，因為TAPI不知道如何封送處理私人指標所指向的數據， () ，並透過進程間通訊與應用程式傳達。 欄位的大小是由 dwReceivingFlowspecSize 所指定。
dwDeviceClassSize
裝置類別字串的大小，包括 null 終止符，以位元組為單位。
dwDeviceClassOffset
從結構的開頭位移至 Null 終止的字串，指出 DeviceConfig 中所指定設定之裝置的裝置類別。 有效的裝置類別字串與 針對lineGetID 函式指定的字串相同。 字串的大小是由 dwDeviceClassSize 所指定。
dwDeviceConfigSize
裝置組態數據的大小，以位元組為單位。
dwDeviceConfigOffset
從結構的開頭位移到不透明的組態數據結構。 此值會在lineGetDevConfig所傳回之 VARSTRING 結構中的 dwStringSize 成員中傳回。 如果大小為零，則會使用預設裝置組態。 這可讓應用程式在起始呼叫之前設定裝置組態。 欄位的大小是由 dwDeviceConfigSize 所指定。
dwCallDataSize
應用程式可設定呼叫數據的大小，以位元組為單位。
dwCallDataOffset
從結構的開頭位移至應用程式可設定的呼叫數據，一開始要附加至呼叫。 欄位的大小是由 dwCallDataSize 所指定。
dwNoAnswerTimeout
完成撥號之後的秒數，應該允許呼叫在 PROCEEDING 或 RINGBACK 狀態中等候，再由服務提供者自動放棄具有LINECALLSTATE_DISCONNECTED和LINEDISCONNECTMODE_NOANSWER。 值為 0 表示應用程式不需要自動呼叫放棄。
dwCallingPartyIDSize
呼叫端標識符字串的大小，包括 Null 終止符，以位元組為單位，包括 Null 終止字元。
dwCallingPartyIDOffset
從結構的開頭位移至 以 Null 結束的字串，指定放置呼叫之合作物件的身分識別。 如果可接受的標識碼內容且路徑可供使用，服務提供者會將標識碼連同被呼叫者一起傳遞，以指出呼叫端的身分識別。 欄位的大小是由 dwCallingPartyIDSize 所指定。
dwAddressType
用於呼叫的地址類型。 只有在交涉的 TAPI 版本為 3.0 或更新版本時，才能使用結構的這個成員。
備註
裝置特定的擴充功能應該使用DevSpecific (dwDevSpecificSize 和 dwDevSpecificOffset) 此數據結構的可變大小區域。
當設定呼叫時，這個結構會當做 lineMakeCall 的參數使用。 其欄位可讓應用程式指定從網路所要求的服務品質，以及各種ISDN呼叫設定參數。 如果未將 LINECALLPARAMS 結構提供給 lineMakeCall，則會要求使用上面所列的預設值來要求預設 POTS 語音等級通話。
規格需求
| 標頭 | tapi.h |