fonction TSPI_phoneGetDisplay (tspi.h)
La fonction TSPI_phoneGetDisplay retourne le contenu actuel de l’affichage du téléphone spécifié.
Syntaxe
LONG TSPIAPI TSPI_phoneGetDisplay(
HDRVPHONE hdPhone,
LPVARSTRING lpDisplay
);
Paramètres
hdPhone
La poignée du téléphone à interroger.
lpDisplay
Pointeur vers l’emplacement de mémoire où le contenu d’affichage doit être stocké par le fournisseur, de type VARSTRING. Avant d’appeler TSPI_phoneGetDisplay, l’application définit le membre dwTotalSize de cette structure pour indiquer la quantité de mémoire disponible pour TAPI pour retourner des informations.
Valeur retournée
Retourne zéro si la fonction réussit, ou un numéro d’erreur si une erreur se produit. Les valeurs de retour possibles sont les suivantes :
PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.
Remarques
La zone de mémoire lpDisplay doit avoir au moins la taille des élémentsdwDisplayNumColumns dwDisplayNumRows * pour recevoir toutes les informations d’affichage. Les membres dwDisplayNumRows et dwDisplayNumColumns sont disponibles dans la structure PHONECAPS retournée par TSPI_phoneGetDevCaps.
Le fournisseur de services remplit tous les membres de la structure de données VARSTRING , à l’exception de dwTotalSize, qui est renseigné par TAPI. Le fournisseur de services ne doit pas remplacer le membre dwTotalSize .
Configuration requise
| Plateforme cible | Windows |
| En-tête | tspi.h |