lineSetDevConfigW 函式（tapi.h）

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

語法

LONG lineSetDevConfigW(
  DWORD        dwDeviceID,
  LPVOID const lpDeviceConfig,
  DWORD        dwSize,
  LPCWSTR      lpszDeviceClass
);

參數

dwDeviceID

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

lpDeviceConfig

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

dwSize

lpDeviceConfig 所指向之結構中的位元元組數目。此值會在 varSTRING 結構中 lineGetDevConfig所傳回的 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（裝置類別）、未記載且未定義。應用程式必須將它視為「不透明」，而不會直接操作內容。一般而言，結構只能使用此函式傳送至從中取得的相同裝置。不過，某些電話語音服務提供者可能會允許在相同的裝置之間交換結構（也就是相同多埠數據機卡上的多個埠）。即使是相同裝置類別的裝置，這種可互換性也不保證。

某些服務提供者可能會允許在通話作用中時設定組態，而其他提供者則不允許設定。

注意

tapi.h 標頭會將lineSetDevConfig定義為別名，根據UNICODE預處理器常數的定義，自動選取此函式的ANSI或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。