Поделиться через

Метод ITLegacyAddressMediaControl::GetDevConfig (tapi3if.h)

  • Статья

Метод GetDevConfig возвращает непрозрачную структуру данных. Точное содержимое зависит от поставщика услуг и класса устройства. Структура данных указывает конфигурацию устройства, связанного с конкретным устройством линии. Например, содержимое этой структуры может указывать скорость передачи данных, формат символов, схемы модуляции и параметры протокола управления ошибками для устройства datamodem, связанного со строкой.

Синтаксис

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
 Для выполнения операции недостаточно памяти.

Комментарии

Этот метод является оболочкой COM для функции TAPI 2.1 LineGetDevConfig .

Перед вызовом этого метода необходимо выполнить getID .

Приложение должно использовать SysAllocString для выделения памяти для параметра pDeviceClass и использовать SysFreeString для освобождения памяти, когда переменная больше не нужна.

Приложение должно вызвать функцию CoTaskMemFree , чтобы освободить память, выделенную для параметра ppDeviceConfig .

Перекрестные ссылки TAPI 2.1: lineGetDevConfig, lineSetDevConfig

Требования

Требование Значение
Целевая платформа Windows
Header tapi3if.h (включая Tapi3.h)
Библиотека Uuid.lib
DLL Tapi3.dll

См. также раздел

ITLegacyAddressMediaControl

ITLegacyCallMediaControl

SetDevConfig