Método ITLegacyAddressMediaControl::GetDevConfig (tapi3if.h)

El método GetDevConfig devuelve una estructura de datos opaca. El contenido exacto es específico del proveedor de servicios y la clase de dispositivo. La estructura de datos especifica la configuración de un dispositivo asociado a un dispositivo de línea determinado. Por ejemplo, el contenido de esta estructura podría especificar la velocidad de datos, el formato de caracteres, los esquemas de modulación y la configuración del protocolo de control de errores para un dispositivo datamodem asociado a la línea.

Sintaxis

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

Parámetros

[in] pDeviceClass

Puntero a BSTR que contiene la clase de dispositivo TAPI para la que se necesita información de configuración.

[out] pdwSize

Puntero al tamaño de la matriz de configuración.

[out] ppDeviceConfig

Puntero a matriz de bytes que contienen información de configuración del dispositivo.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	El método se realizó correctamente.
E_POINTER	El parámetro pDeviceClass, pdwSize o ppDeviceConfig no es un puntero válido.
E_OUTOFMEMORY	Existe memoria insuficiente para realizar la operación.

Comentarios

Este método es un contenedor COM para la función TAPI 2.1 LineGetDevConfig .

El GetID debe realizarse antes de llamar a este método.

La aplicación debe usar SysAllocString para asignar memoria para el parámetro pDeviceClass y usar SysFreeString para liberar la memoria cuando la variable ya no sea necesaria.

La aplicación debe llamar a la función CoTaskMemFree para liberar la memoria asignada para el parámetro ppDeviceConfig .

Referencias cruzadas de TAPI 2.1: lineGetDevConfig, lineSetDevConfig

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	tapi3if.h (incluya Tapi3.h)
Library	Uuid.lib
Archivo DLL	Tapi3.dll

Consulte también

ITLegacyAddressMediaControl

ITLegacyCallMediaControl

SetDevConfig