Compartir a través de

función TSPI_lineDevSpecific (tspi.h)

La función TSPI_lineDevSpecific se usa como mecanismo de extensión general para permitir que los proveedores de servicios proporcionen acceso a características que no se describen en otras operaciones. Los significados de las extensiones son específicos del dispositivo y para aprovechar estas extensiones, la aplicación debe ser totalmente consciente de ellas.

Sintaxis

LONG TSPIAPI TSPI_lineDevSpecific(
  DRV_REQUESTID dwRequestID,
  HDRVLINE      hdLine,
  DWORD         dwAddressID,
  HDRVCALL      hdCall,
  LPVOID        lpParams,
  DWORD         dwSize
);

Parámetros

dwRequestID

Identificador de la solicitud asincrónica.

hdLine

El identificador del proveedor de servicios en la línea en la que se va a operar.

dwAddressID

Dirección de la línea especificada en la que se va a operar. Un identificador de dirección está asociado permanentemente a una dirección; el identificador permanece constante en las actualizaciones del sistema operativo.

hdCall

El identificador del proveedor de servicios en la llamada en la que se va a operar. Este campo puede tener el valor NULL. El estado de llamada de hdCall es específico del dispositivo.

lpParams

Puntero a un área de memoria utilizada para contener un bloque de parámetros. El formato de este bloque de parámetros es específico del dispositivo.

dwSize

Tamaño en bytes del área de bloque de parámetros. Si el parámetro lpParams es un puntero a una cadena, el tamaño debe incluir el terminador null .

Valor devuelto

Devuelve dwRequestID o un número de error si se produce un error. El parámetro real lResult del ASYNC_COMPLETION correspondiente es cero si la función se realiza correctamente o si se produce un error. Los valores devueltos posibles son los siguientes:

LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Comentarios

Los valores devueltos adicionales son específicos del dispositivo.

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

Esta función se llama en respuesta directa a una aplicación que llama a la función TAPI lineDevSpecific. TAPI traduce los parámetros hLine y hdCall usados en el nivel TAPI a los parámetros hdLine y hdCall correspondientes que se usan en el nivel de TSPI. El búfer lpParams se pasa sin modificar.

Nota La estructura de datos lpParams no debe contener punteros porque no se traducirían correctamente (matones) al ejecutar una aplicación de 16 bits en una versión de 32 bits de TAPI y viceversa.
 
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 operación. Las aplicaciones que quieran usar estas extensiones específicas del dispositivo deben consultar la documentación específica del dispositivo (en este caso, lo que significa específico del proveedor) que describe qué extensiones se definen.
Nota Una aplicación que se basa en extensiones específicas del dispositivo no es portátil en el trabajo con otros entornos del proveedor de servicios. Use extensiones específicas del proveedor.
 
Esta operación forma parte de los servicios de telefonía extendida. Solo 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 y seleccionado una versión de extensión específica del dispositivo.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado tspi.h

Consulte también

ASYNC_COMPLETION

LINE_DEVSPECIFIC

TSPI_lineNegotiateExtVersion

  • Last updated on