función TSPI_phoneGetDisplay (tspi.h)
La función TSPI_phoneGetDisplay devuelve el contenido actual de la pantalla de teléfono especificada.
Sintaxis
LONG TSPIAPI TSPI_phoneGetDisplay(
HDRVPHONE hdPhone,
LPVARSTRING lpDisplay
);
Parámetros
hdPhone
Identificador del teléfono que se va a consultar.
lpDisplay
Puntero a la ubicación de memoria donde el proveedor va a almacenar el contenido para mostrar, de tipo VARSTRING. Antes de llamar a TSPI_phoneGetDisplay, la aplicación establece el miembro dwTotalSize de esta estructura para indicar la cantidad de memoria disponible para TAPI para devolver información.
Valor devuelto
Devuelve cero si la función se ejecuta correctamente o un número de error si se produce un error. Los valores devueltos posibles son los siguientes:
PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.
Comentarios
El área de memoria lpDisplay debe ser al menos dwDisplayNumRows * dwDisplayNumColumns de tamaño para recibir toda la información de visualización. Los miembros dwDisplayNumRows y dwDisplayNumColumns están disponibles en la estructura PHONECAPS devuelta por TSPI_phoneGetDevCaps.
El proveedor de servicios rellena todos los miembros de la estructura de datos VARSTRING , excepto dwTotalSize, rellenado por TAPI. El proveedor de servicios no debe sobrescribir el miembro dwTotalSize .
Requisitos
| Plataforma de destino | Windows |
| Encabezado | tspi.h |