función TSPI_lineDevSpecificFeature (tspi.h)

La función TSPI_lineDevSpecificFeature se usa como mecanismo de extensión para permitir que los proveedores de servicios proporcionen acceso a características que no se describen en otras operaciones. Los significados de estas extensiones son específicos del dispositivo y aprovechar estas extensiones requiere QUE TAPI o su aplicación cliente sean totalmente conscientes de ellas.

Sintaxis

LONG TSPIAPI TSPI_lineDevSpecificFeature(
  DRV_REQUESTID dwRequestID,
  HDRVLINE      hdLine,
  DWORD         dwFeature,
  LPVOID        lpParams,
  DWORD         dwSize
);

Parámetros

dwRequestID

Identificador de la solicitud asincrónica.

hdLine

Identificador del proveedor de servicios para el dispositivo de línea.

dwFeature

Característica que se va a invocar en el dispositivo de línea. Este parámetro usa constantes PHONEBUTTONFUNCTION_.

lpParams

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

dwSize

Tamaño del búfer en bytes. 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_INVALFEATURE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Comentarios

Los valores devueltos adicionales son específicos del dispositivo. El estado de llamada de hdCall es específico del dispositivo.

Esta función proporciona a las aplicaciones TAPI funcionalidades de emulación de botón de características telefónicas. Cuando TAPI invoca esta operación en nombre de una aplicación cliente, especifica el equivalente de un evento de "botón". Este método de invocación de características es muy dependiente del dispositivo, ya que la API no define su significado. Cuando una aplicación se basa en extensiones específicas del dispositivo, la aplicación no se porta bien a otros entornos del proveedor de servicios.

Esta función se llama en respuesta directa a una aplicación que llama a la función lineDevSpecificFeature de TAPI. TAPI traduce el parámetro hLine usado en el nivel TAPI al parámetro hdLine correspondiente que se usa en el nivel de TSPI. El búfer lpParams se pasa a través de unmodified.

Nota La estructura de datos lpParams no debe contener punteros porque no se traducen correctamente (matones) al ejecutar una aplicación de 16 bits en una versión de 32 bits de TAPI y viceversa.

 

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 TAPI 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_DEVSPECIFICFEATURE

constantes de PHONEBUTTONFUNCTION_