Función lineSetDevConfig (tapi.h)

Artículo
03/05/2024

La función lineSetDevConfig 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 lineGetDevConfig. 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 multimedia "datamodem" asociado a la línea.

Sintaxis

LONG lineSetDevConfig(
  DWORD        dwDeviceID,
  LPVOID const lpDeviceConfig,
  DWORD        dwSize,
  LPCSTR       lpszDeviceClass
);

Parámetros

dwDeviceID

Identificador del dispositivo de línea que se va a configurar.

lpDeviceConfig

Puntero a la estructura de datos de configuración opaca devuelta por lineGetDevConfig en la parte variable de la estructura VARSTRING .

dwSize

Número de bytes de la estructura a la que apunta lpDeviceConfig. Este valor se devuelve en el miembro dwStringSize de la estructura VARSTRING devuelta por lineGetDevConfig.

lpszDeviceClass

Puntero a una cadena terminada en null que especifica la clase de dispositivo del dispositivo cuya configuración se va a establecer. Las cadenas de clase de dispositivo válidas son las mismas que las especificadas para la función lineGetID .

Valor devuelto

Devuelve cero si la función se realiza correctamente o un número de error negativo si se produce un error. Los valores devueltos posibles son:

LINEERR_BADDEVICEID, LINEERR_NODRIVER, LINEERR_INVALDEVICECLASS, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALPOINTER, LINEERR_OPERATIONFAILED, LINEERR_INVALPARAM, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALLINESTATE, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_NODEVICE.

Comentarios

Los estados de llamada son específicos del dispositivo.

Normalmente, una aplicación llama a lineGetID para identificar el dispositivo de secuencia multimedia asociado a una línea y, a continuación, llama a lineConfigDialog para permitir al usuario configurar la configuración del dispositivo. Después, podría llamar a lineGetDevConfig y guardar la información de configuración en una libreta de teléfonos u otra base de datos asociada a un destino de llamada determinado. Cuando el usuario quiere volver a llamar al mismo destino, esta función lineSetDevConfig se puede usar para restaurar las opciones de configuración seleccionadas por el usuario. Las funciones lineSetDevConfig, lineConfigDialog y lineGetDevConfig se pueden usar, en ese orden, para permitir al usuario ver y actualizar la configuración.

El formato exacto de los datos contenidos en la estructura es específico de la API de flujo multimedia y de línea (clase de dispositivo), no está documentado y no está definido. La aplicación debe tratarla como "opaca" y no manipular el contenido directamente. Por lo general, la estructura solo se puede enviar mediante esta función al mismo dispositivo desde el que se obtuvo. Sin embargo, algunos proveedores de servicios de telefonía pueden permitir el intercambio de estructuras entre dispositivos idénticos (es decir, varios puertos en la misma tarjeta de módem multipuerto). Dicha intercambiablebilidad no está garantizada de ninguna manera, incluso para dispositivos de la misma clase de dispositivo.

Algunos proveedores de servicios pueden permitir que la configuración se establezca mientras una llamada está activa y otras pueden no hacerlo.