Función lineGetDevConfig (tapi.h)

Artículo
03/09/2024

La función lineGetDevConfig devuelve un objeto de estructura de datos "opaco", cuyo contenido es específico de la línea (proveedor de servicios) y la clase de dispositivo. El objeto de estructura de datos almacena la configuración actual de un dispositivo de flujo multimedia asociado al dispositivo de línea.

Sintaxis

LONG lineGetDevConfig(
  DWORD       dwDeviceID,
  LPVARSTRING lpDeviceConfig,
  LPCSTR      lpszDeviceClass
);

Parámetros

dwDeviceID

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

lpDeviceConfig

Puntero a la ubicación de memoria del tipo VARSTRING donde se devuelve la estructura de configuración del dispositivo. Tras completar correctamente la solicitud, esta ubicación se rellena con la configuración del dispositivo. El miembro dwStringFormat de la estructura VARSTRING se establece en STRINGFORMAT_BINARY. Antes de llamar a lineGetDevConfig, la aplicación debe establecer el miembro dwTotalSize de esta estructura para indicar la cantidad de memoria disponible para TAPI para devolver información.

Nota Si los parámetros de tamaño de la estructura no son correctos, existe la posibilidad de que se sobrescriban los datos. Para obtener más información sobre cómo establecer tamaños de estructura, consulte el tema de asignación de memoria .

lpszDeviceClass

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

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_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_NODEVICE.

Comentarios

Los estados de llamada son específicos del dispositivo.

La función lineGetDevConfig se puede usar para recuperar una estructura de datos de TAPI que especifica la configuración de un dispositivo de flujo multimedia 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 multimedia "datamodem" asociado a la línea.

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 desea llamar de nuevo al mismo destino, 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 secuencia multimedia y de línea (clase de dispositivo), no está documentado y no está definido. La estructura devuelta por esta función no puede ser accesible directamente o manipulada por la aplicación, pero solo se puede almacenar intacta y después usarse en lineSetDevConfig para restaurar la configuración. La estructura tampoco se puede pasar necesariamente a otros dispositivos, incluso de la misma clase de dispositivo (aunque esto puede funcionar en algunos casos, no se garantiza).