lineGetDevConfigW 函式（tapi.h）

lineGetDevConfig 函式會傳回「不透明」數據結構物件，其內容是線路（服務提供者）和裝置類別特有的內容。數據結構物件會儲存與線路裝置相關聯之媒體串流裝置的目前組態。

語法

LONG lineGetDevConfigW(
  DWORD       dwDeviceID,
  LPVARSTRING lpDeviceConfig,
  LPCWSTR     lpszDeviceClass
);

參數

dwDeviceID

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

lpDeviceConfig

VARSTRING 類型的記憶體位置指標，傳回裝置組態結構的位置。成功完成要求時，此位置會填入裝置組態。 VARSTRING 結構中的 dwStringFormat 成員會設定為 STRINGFORMAT_BINARY。在呼叫 lineGetDevConfig之前，應用程式必須設定此結構的 dwTotalSize 成員，以指出 TAPI 可用來傳回資訊的記憶體數量。

注意如果結構中的大小參數不正確，可能會覆寫數據。如需設定結構大小的詳細資訊，請參閱記憶體配置主題。

lpszDeviceClass

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

傳回值

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

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

言論

通話狀態為裝置特定。

lineGetDevConfig 函式可用來從 TAPI 擷取數據結構，以指定與特定線路裝置相關聯的媒體串流裝置組態。例如，此結構的內容可以指定與該行相關聯的「datamodem」媒體裝置的數據速率、字元格式、調節配置和錯誤控制通訊協定設定。

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

結構中包含的數據確切格式是行和媒體串流 API（裝置類別）、未記載且未定義。此函式傳回的結構無法由應用程式直接存取或操作，但只能完整儲存，稍後再用於 lineSetDevConfig 還原設定。結構也不一定傳遞至其他裝置，即使是相同裝置類別也一樣（雖然這在某些情況下可以運作，但並不保證）。

注意

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