lineSetDevConfig 函式 (tapi.h)

發行項
03/05/2024

lineSetDevConfig 函式可讓應用程式將線路裝置上的媒體串流裝置設定還原至先前使用lineGetDevConfig取得的設定。例如，此結構的內容可以指定與該行相關聯之「datamodem」媒體裝置的數據速率、字元格式、音調配置和錯誤控制通訊協定設定。

語法

LONG lineSetDevConfig(
  DWORD        dwDeviceID,
  LPVOID const lpDeviceConfig,
  DWORD        dwSize,
  LPCSTR       lpszDeviceClass
);

參數

dwDeviceID

要設定之線路裝置的標識碼。

lpDeviceConfig

VARSTRING 結構之變數部分中 lineGetDevConfig 所傳回之不透明組態數據結構的指標。

dwSize

lpDeviceConfig 所指向結構中的位元元組數目。此值會在lineGetDevConfig所傳回之 VARSTRING 結構中的 dwStringSize 成員中傳回。

lpszDeviceClass

Null 終止字串的指標，指定要設定其組態之裝置的裝置類別。有效的裝置類別字串與針對lineGetID 函式指定的字串相同。

傳回值

如果函式成功，則傳回零，如果發生錯誤，則傳回負錯誤號碼。可能的傳回值為：

LINEERR_BADDEVICEID、LINEERR_NODRIVER、LINEERR_INVALDEVICECLASS、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALPOINTER、LINEERR_OPERATIONFAILED、LINEERR_INVALPARAM、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALLINESTATE、LINEERR_UNINITIALIZED、LINEERR_NOMEM、LINEERR_NODEVICE。

備註

通話狀態是裝置特定的。

一般而言，應用程式會呼叫 lineGetID 來識別與一行相關聯的媒體串流裝置，然後呼叫 lineConfigDialog 以允許使用者設定裝置組態。然後，它可以呼叫 lineGetDevConfig ，並將設定資訊儲存在電話簿或其他與特定通話目的地相關聯的資料庫中。當使用者想要再次呼叫相同的目的地時，此 lineSetDevConfig 函式可用來還原用戶選取的組態設定。 lineSetDevConfig、lineConfigDialog 和 lineGetDevConfig 函式可用來讓用戶檢視和更新設定。

結構內所含數據的確切格式專屬於裝置類別) (裝置類別的行和媒體串流 API、未記載，且未定義。應用程式必須將它視為「不透明」，而不會直接操作內容。一般而言，結構只能使用此函式傳送到從中取得它的相同裝置。不過，某些電話語音服務提供者可能會允許在相同裝置之間交換結構， (也就是相同多埠數據機卡上的多個埠) 。即使針對相同裝置類別的裝置，這類可交換性也不保證。

有些服務提供者可能會允許在呼叫為作用中時設定設定，而其他提供者則不允許設定。