共用方式為


LINECALLPARAMS 結構 (tapi.h)

LINECALLPARAMS 結構描述使用lineMakeCallTSPI_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 每秒 (位) 。 呼叫時,服務提供者會嘗試在要求的範圍中提供最高可用速率, (dwMinRatedwMaxRate) 。 如果需要特定數據速率, dwMinRatedwMaxRate 都應該設定為該值。 如果應用程式最適合使用一個速率,但能夠降低為較低的速率,則應用程式應該分別將這些專案指定為最大值和最小速率。 如果 dwMaxRate 是零,則預設值是由 LINEDEVCAPS 結構的 dwMaxRate 成員所指定。 這是裝置所支援的最大速率。

dwMediaMode

呼叫的預期媒體類型。 此成員會使用其中一個 LINEMEDIAMODE_常數

如果 dwMediaMode 為零,則預設值為 LINEMEDIAMODE_INTERACTIVEVOICE。

dwCallParamFlags

布爾值呼叫設定參數的集合。 此成員會使用一或多個 LINECALLPARAMFLAGS_常數

dwAddressMode

指定原始位址的模式。 此成員會使用其中一個 LINEADDRESSMODE_常數

注意lineOpen 函數調用無法LINEADDRESSMODE_ADDRESSID dwAddressMode 成員。 不過,此限制不適用於 lineMakeCall
 

dwAddressID

如果 dwAddressMode 設定為 LINEADDRESSMODE_ADDRESSID,則來源地址的地址識別符。 位址標識符永久與地址相關聯;標識碼在操作系統升級之間維持不變。

DialParams

要在此呼叫上使用的撥號參數,類型為 LINEDIALPARAMS。 指定此欄位的值為 0 時,欄位的預設值會如 LINEDEVCAPS 結構的 DefaultDialParams 成員所示使用。 如果針對在LINEDEVCAPS結構中MinDialParamsMaxDialParams中對應欄位所指定的範圍以外的欄位指定非零值,則會改用有效範圍內的最接近值。

dwOrigAddressSize

原始位址欄位的大小,以位元組為單位。

dwOrigAddressOffset

從結構開頭位移到保留原始位址的可變大小欄位。 此位址的格式取決於 dwAddressMode 成員。 欄位的大小是由 dwOrigAddressSize 所指定。

dwDisplayableAddressSize

可顯示字串的大小,包括 null 終止符,以位元組為單位。

dwDisplayableAddressOffset

用於記錄用途的可顯示字串。 這些成員的內容會記錄在呼叫之 LINECALLINFO 訊息的 dwDisplayableAddressOffsetdwDisplayableAddressSize 成員中。 lineTranslateAddress 函式會傳回要放置在 LINETRANSLATEOUTPUT 結構的 dwDisplayableAddressSizedwDisplayableAddressOffset 成員中的適當資訊。 欄位的大小是由 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 (dwDevSpecificSizedwDevSpecificOffset) 此數據結構的可變大小區域。

當設定呼叫時,這個結構會當做 lineMakeCall 的參數使用。 其欄位可讓應用程式指定從網路所要求的服務品質,以及各種ISDN呼叫設定參數。 如果未將 LINECALLPARAMS 結構提供給 lineMakeCall,則會要求使用上面所列的預設值來要求預設 POTS 語音等級通話。

注意當使用lineOpen函式指定 lpCallParams 參數時,會忽略透過 dwDevSpecificOffsetDialParams 欄位。
 
dwPredictiveAutoTransferStates 透過 dwCallingPartyIDOffset 的成員僅適用於以 API 版本 2.0 或更新版本開啟行裝置的應用程式。

規格需求

   
標頭 tapi.h

另請參閱

LINEDEVCAPS

LINEDIALPARAMS

LINETRANSLATEOUTPUT

TSPI_lineMakeCall

VARSTRING

lineBlindTransfer

lineGetDevConfig

lineGetID

lineMakeCall

lineOpen

lineTranslateAddress