Compartir a través de


función TSPI_phoneDevSpecific (tspi.h)

La función TSPI_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 demás operaciones. Los significados de estas extensiones son específicos del dispositivo.

Sintaxis

LONG TSPIAPI TSPI_phoneDevSpecific(
  DRV_REQUESTID dwRequestID,
  HDRVPHONE     hdPhone,
  LPVOID        lpParams,
  DWORD         dwSize
);

Parámetros

dwRequestID

Identificador de la solicitud asincrónica.

hdPhone

Identificador del teléfono en el que se va a realizar una operación específica del dispositivo.

lpParams

Puntero a un área de memoria utilizada para contener un bloque de parámetros. Su interpretación es específica del dispositivo. El parámetro lpParams no debe contener punteros. Para obtener información de vuelta a la aplicación desde TSPI_phoneDevSpecific, el proveedor de servicios envía un mensaje de PHONE_DEVSPECIFIC con la información.

dwSize

Tamaño en bytes del área de bloque de parámetros.

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 es un número de error si se produce un error. Los valores devueltos posibles son los siguientes:

PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_NOMEM, PHONEERR_OPERATIONFAILED, PHONEERR_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 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 .

Esta función se llama en respuesta directa a una aplicación que ha llamado a la función phoneDevSpecific tapI. TAPI traduce el parámetro hPhone usado en el nivel TAPI al parámetro hdPhone correspondiente usado en el nivel de TSPI. El búfer lpParams se pasa a través de unmodified.

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.

Nota Normalmente, una aplicación que se basa en estas extensiones específicas del dispositivo no es portátil en el trabajo con otros entornos del proveedor de servicios.
 

Requisitos

   
Plataforma de destino Windows
Encabezado tspi.h

Consulte también

ASYNC_COMPLETION

PHONE_DEVSPECIFIC