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 |