ITLegacyAddressMediaControl::GetDevConfig 方法 (tapi3if.h)
GetDevConfig 方法返回不透明的数据结构。 确切的内容特定于服务提供商和设备类。 数据结构指定与特定线路设备关联的设备的配置。 例如,此结构的内容可以为与行关联的数据模式设备指定数据速率、字符格式、调节方案和错误控制协议设置。
语法
HRESULT GetDevConfig(
[in] BSTR pDeviceClass,
[out] DWORD *pdwSize,
[out] BYTE **ppDeviceConfig
);
参数
[in] pDeviceClass
指向包含需要配置信息的 TAPI 设备类的 BSTR 的指针。
[out] pdwSize
指向配置数组大小的指针。
[out] ppDeviceConfig
指向包含设备配置信息的字节数组的指针。
返回值
此方法可以返回其中一个值。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
pDeviceClass、pdwSize 或 ppDeviceConfig 参数不是有效的指针。 |
|
内存不足,无法执行操作。 |
注解
此方法是 LineGetDevConfig TAPI 2.1 函数的 COM 包装器。
在调用此方法之前,必须执行 GetID 。
应用程序必须使用 SysAllocString 为 pDeviceClass 参数分配内存,并在不再需要变量时使用 SysFreeString 释放内存。
应用程序必须调用 CoTaskMemFree 函数来释放为 ppDeviceConfig 参数分配的内存。
TAPI 2.1 交叉引用: lineGetDevConfig、 lineSetDevConfig
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | tapi3if.h (包括 Tapi3.h) |
Library | Uuid.lib |
DLL | Tapi3.dll |