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

Artículo
03/02/2024

La función SetDevConfig permite a la aplicación restaurar la configuración de un dispositivo de secuencia multimedia en un dispositivo de línea a una configuración obtenida previamente mediante GetDevConfig.

Sintaxis

HRESULT SetDevConfig(
  [in] BSTR  pDeviceClass,
  [in] DWORD dwSize,
  [in] BYTE  *pDeviceConfig
);

Parámetros

[in] pDeviceClass

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

[in] dwSize

Tamaño de la matriz de configuración.

[in] pDeviceConfig

Puntero a la matriz de bytes que contiene la información de configuración del dispositivo obtenida por una llamada a GetDevConfig.

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_INVALIDARG	El parámetro pdwSize es cero.
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 lineSetDevConfig .

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.

Referencias cruzadas de TAPI 2.1: lineGetDevConfig, lineSetDevConfig