ITLegacyAddressMediaControl：：GetDevConfig 方法 (tapi3if.h)

GetDevConfig 方法會傳回不透明的數據結構。確切的內容專屬於服務提供者和裝置類別。數據結構會指定與特定線條裝置相關聯的裝置組態。例如，此結構的內容可以指定與該行相關聯之數據模式裝置的數據速率、字元格式、音調配置和錯誤控制通訊協定設定。

語法

HRESULT GetDevConfig(
  [in]  BSTR  pDeviceClass,
  [out] DWORD *pdwSize,
  [out] BYTE  **ppDeviceConfig
);

[in] pDeviceClass

BSTR 的指標，其中包含需要設定資訊的 TAPI 裝置類別。

[out] pdwSize

組態陣列大小的指標。

[out] ppDeviceConfig

包含裝置組態資訊的位元組陣列指標。

這個方法可以傳回下列其中一個值。

傳回碼	描述
S_OK	方法成功。
E_POINTER	pDeviceClass、pdwSize 或 ppDeviceConfig 參數不是有效的指標。
E_OUTOFMEMORY	記憶體不足，無法執行作業。

這個方法是 LineGetDevConfigTAPI 2.1函式的 COM 包裝函式。

必須先執行 GetID，才能呼叫這個方法。

應用程式必須使用 SysAllocString 為 pDeviceClass 參數配置記憶體，並在不再需要變數時使用 SysFreeString 釋放記憶體。

應用程式必須呼叫 CoTaskMemFree 函式，以釋放配置給 ppDeviceConfig 參數的記憶體。

TAPI 2.1 交叉參考： lineGetDevConfig、 lineSetDevConfig