fonction TSPI_phoneGetStatus (tspi.h)
La fonction TSPI_phoneGetStatus interroge l’appareil téléphonique ouvert spécifié pour son status global.
Syntaxe
LONG TSPIAPI TSPI_phoneGetStatus(
HDRVPHONE hdPhone,
LPPHONESTATUS lpPhoneStatus
);
Paramètres
hdPhone
La poignée du téléphone à interroger.
lpPhoneStatus
Pointeur vers une structure de données de taille variable de type PHONESTATUS, dans laquelle le fournisseur de services écrit des informations sur les status du téléphone. Avant d’appeler TSPI_phoneGetStatus, 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_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_RESOURCEUNAVAIL.
Remarques
Le tableau suivant indique quels membres de la structure de données PHONESTATUS sont renseignés par TAPI et quels membres sont renseignés par le fournisseur de services. Le fournisseur de services ne doit pas remplacer les valeurs renseignées par TAPI.
| Membre | TAPI | Fournisseur de services |
|---|---|---|
| dwTotalSize ; | X | |
| dwNeedSize ; | X | |
| dwUsedSize ; | X | |
| dwStatusFlags ; | X | |
| dwNumOwners ; | X | |
| dwNumMonitors ; | X | |
| dwRingMode ; | X | |
| dwRingVolume ; | X | |
| dwHandsetHookSwitchMode ; | X | |
| dwHandsetVolume ; | X | |
| dwHandsetGain ; | X | |
| dwSpeakerHookSwitchMode ; | X | |
| dwSpeakerVolume ; | X | |
| dwSpeakerGain ; | X | |
| dwHeadsetHookSwitchMode ; | X | |
| dwHeadsetVolume ; | X | |
| dwHeadsetGain ; | X | |
| dwDisplaySize ; | X | |
| dwDisplayOffset ; | X | |
| dwLampModesSize ; | X | |
| dwLampModesOffset ; | X | |
| dwOwnerNameSize ; | X | |
| dwOwnerNameOffset ; | X | |
| dwDevSpecificSize ; | X | |
| dwDevSpecificOffset ; | X |
TAPI peut utiliser cette fonction pour déterminer l’état actuel d’un appareil téléphonique ouvert. Les informations status décrivent des informations sur les appareils de raccordement, la sonnerie, le volume, l’affichage et les lampes du téléphone ouvert.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |