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.
Requisitos
Plataforma de destino | Windows |
Encabezado | tspi.h |