Función phoneDevSpecific (tapi.h)

Artículo
03/02/2024

La función phoneDevSpecific se usa como mecanismo de extensión general para habilitar una implementación de api de telefonía para proporcionar características que no se describen en las otras funciones TAPI. Los significados de estas extensiones son específicos del dispositivo.

Sintaxis

LONG phoneDevSpecific(
  HPHONE hPhone,
  LPVOID lpParams,
  DWORD  dwSize
);

Parámetros

hPhone

Identificador de un dispositivo telefónico.

lpParams

Puntero a un área de memoria usada para contener un bloque de parámetros. Su interpretación es específica del dispositivo. TapI pasa el contenido del bloque de parámetros sin cambios a 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 PHONE_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:

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONFAILED.

Los valores devueltos adicionales son específicos del dispositivo.

Comentarios

Esta operación proporciona un perfil de parámetro genérico. La interpretación del bloque de parámetros es específica del dispositivo. Las indicaciones y respuestas que son específicas del dispositivo deben usar el mensaje de PHONE_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 operación. Las aplicaciones que quieran usar estas extensiones específicas del dispositivo deben consultar la documentación específica del dispositivo (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 es portátil para trabajar con otros entornos de proveedor de servicios.