lineGetDevConfig 函式 (tapi.h)

發行項
03/13/2024

lineGetDevConfig 函式會傳回「opaque」資料結構物件，其內容專屬於 (服務提供者) 和裝置類別。數據結構物件會儲存與線條裝置相關聯之媒體串流裝置的目前組態。

語法

LONG lineGetDevConfig(
  DWORD       dwDeviceID,
  LPVARSTRING lpDeviceConfig,
  LPCSTR      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 中用來還原設定。結構也不一定傳遞至其他裝置，即使相同的裝置類別 (，雖然這在某些實例中可以運作，但並不保證) 。