Partager via

fonction TSPI_phoneGetStatus (tspi.h)

  • Article

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

Voir aussi

PHONESTATUS

PHONE_STATE