Función lineDevSpecificFeature (tapi.h)

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

Sintaxis

LONG lineDevSpecificFeature(
  HLINE  hLine,
  DWORD  dwFeature,
  LPVOID lpParams,
  DWORD  dwSize
);

Parámetros

hLine

Controle el dispositivo de línea.

dwFeature

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

lpParams

Puntero a un área de memoria que se usa 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 y TAPI pasa su contenido a o desde el proveedor de servicios.

dwSize

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

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 a la aplicación funcionalidades de emulación de botón de características de teléfono. Cuando una aplicación invoca esta operación, especifica el equivalente de un evento de pulsación de botones. Este método de invocar características depende del dispositivo, ya que TAPI no define su significado. Normalmente, una aplicación que se basa en estas extensiones específicas del dispositivo no funciona con otros entornos del proveedor de servicios.

La estructura a la que apunta lpParams no debe contener punteros porque no se traducirían correctamente (thunked) al ejecutar una aplicación de 16 bits en una versión de 32 bits de TAPI y viceversa.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	tapi.h
Library	Tapi32.lib
Archivo DLL	Tapi32.dll

Consulte también

Referencia de servicios de telefonía extendida

LINE_REPLY

Introducción a la referencia de TAPI 2.2