Función lineDevSpecific (tapi.h)

Artículo
08/26/2023

La función lineDevSpecific permite a los proveedores de servicios proporcionar acceso a las características que no ofrecen otras funciones TAPI. El significado de las extensiones es específico del dispositivo y aprovechar estas extensiones requiere que la aplicación sea totalmente consciente de ellas.

Sintaxis

LONG lineDevSpecific(
  HLINE  hLine,
  DWORD  dwAddressID,
  HCALL  hCall,
  LPVOID lpParams,
  DWORD  dwSize
);

Parámetros

hLine

Identificador de un dispositivo de línea. Este parámetro es obligatorio.

dwAddressID

Identificador de dirección en el dispositivo de línea especificado. Un identificador de dirección está asociado permanentemente a una dirección; el identificador permanece constante en las actualizaciones del sistema operativo.

hCall

Identificador de una llamada. Este parámetro es opcional, pero si se especifica, la llamada que representa debe pertenecer al dispositivo de línea hLine . El estado de llamada de hCall es específico del dispositivo.

lpParams

Puntero a un área de memoria usada para contener un bloque de parámetros. El formato de este bloque de parámetros es específico del dispositivo y su contenido se pasa por TAPI hacia o desde el proveedor de servicios.

dwSize

Tamaño del área de bloque de parámetros, en bytes.

Valor devuelto

Devuelve un identificador de solicitud positivo si la función se completa de forma asincrónica o un número de error negativo si se produce un error. El parámetro dwParam2 del mensaje de LINE_REPLY correspondiente es cero si la función se ejecuta correctamente o es un número de error negativo si se produce un error. Los valores devueltos posibles son:

LINEERR_INVALADDRESSID, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Los valores devueltos adicionales son específicos del dispositivo.

Comentarios

Esta operación forma parte de los servicios de telefonía extendida. Proporciona acceso a una característica específica del dispositivo sin definir su significado. Esta operación solo está disponible si la aplicación ha negociado correctamente una versión de extensión específica del dispositivo.

Esta función proporciona un perfil de parámetro genérico. La interpretación de la estructura de parámetros es específica del dispositivo. Si dwAddressID o hCall son válidos es específico del dispositivo. Si se especifica, deben pertenecer a hLine. Las indicaciones y las respuestas enviadas de vuelta a la aplicación que son específicas del dispositivo deben usar el mensaje LINE_DEVSPECIFIC .

Un proveedor de servicios puede proporcionar acceso a funciones específicas del dispositivo mediante la definición de parámetros para su uso con esta función. Las aplicaciones que quieran usar estas extensiones específicas del dispositivo deben consultar la documentación específica del dispositivo (en este caso, específica del proveedor) que describe qué extensiones se definen. Normalmente, una aplicación que se basa en estas extensiones específicas del dispositivo no puede trabajar con otros entornos del proveedor de servicios.

Precaución TAPI escribirá los datos devueltos en el búfer al que hace referencia lParam cuando se devuelva el mensaje LINE_REPLY. Esto significa que el búfer debe permanecer válido hasta que se devuelva el mensaje LINE_REPLY; de lo contrario, pueden producirse daños en los datos y excepciones.