ITLegacyAddressMediaControl::GetDevConfig 方法 (tapi3if.h)

GetDevConfig 方法返回不透明的数据结构。 确切的内容特定于服务提供商和设备类。 数据结构指定与特定线路设备关联的设备的配置。 例如,此结构的内容可以为与行关联的数据模式设备指定数据速率、字符格式、调节方案和错误控制协议设置。

语法

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

参数

[in] pDeviceClass

指向包含需要配置信息的 TAPI 设备类BSTR 的指针。

[out] pdwSize

指向配置数组大小的指针。

[out] ppDeviceConfig

指向包含设备配置信息的字节数组的指针。

返回值

此方法可以返回其中一个值。

返回代码 说明
S_OK
方法成功。
E_POINTER
pDeviceClasspdwSizeppDeviceConfig 参数不是有效的指针。
E_OUTOFMEMORY
内存不足,无法执行操作。

注解

此方法是 LineGetDevConfig TAPI 2.1 函数的 COM 包装器。

在调用此方法之前,必须执行 GetID

应用程序必须使用 SysAllocStringpDeviceClass 参数分配内存,并在不再需要变量时使用 SysFreeString 释放内存。

应用程序必须调用 CoTaskMemFree 函数来释放为 ppDeviceConfig 参数分配的内存。

TAPI 2.1 交叉引用: lineGetDevConfiglineSetDevConfig

要求

要求
目标平台 Windows
标头 tapi3if.h (包括 Tapi3.h)
Library Uuid.lib
DLL Tapi3.dll

另请参阅

ITLegacyAddressMediaControl

ITLegacyCallMediaControl

SetDevConfig