Función lineGetDevConfigW (tapi.h)

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 lineGetDevConfigW(
  DWORD       dwDeviceID,
  LPVARSTRING lpDeviceConfig,
  LPCWSTR     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 en la estructura VARSTRING se establece en STRINGFORMAT_BINARY. Antes de llamar a lineGetDevConfig, la aplicación debe establecer el dwTotalSize miembro 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 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. La clase de dispositivo válida las cadenas lineGetID son las mismas que las especificadas para la función.

Valor devuelto

Devuelve cero si la función se ejecuta 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.

Observaciones

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. A continuación, podría llamar a lineGetDevConfigy 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 quiera volver a llamar al mismo destino, lineSetDevConfig se puede usar para restaurar las opciones de configuración seleccionadas por el usuario. Las funciones lineSetDevConfig, lineConfigDialogy 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 estructura devuelta por esta función no se puede acceder directamente a esta función ni manipularla, pero solo se puede almacenar intacta y posteriormente se puede usar 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 está garantizado).

Nota

El encabezado tapi.h define lineGetDevConfig como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de la plataforma de destino de	Windows
encabezado de	tapi.h
biblioteca de	Tapi32.lib
DLL de	Tapi32.dll

Consulte también

referencia de servicios de telefonía básica de

de información general de referencia de TAPI 2.2

VARSTRING

lineConfigDialog

lineGetID

lineSetDevConfig