fonction TSPI_phoneGetHookSwitch (tspi.h)
La fonction TSPI_phoneGetHookSwitch retourne le mode de connexion actuel de l’appareil téléphonique ouvert spécifié.
Syntaxe
LONG TSPIAPI TSPI_phoneGetHookSwitch(
HDRVPHONE hdPhone,
LPDWORD lpdwHookSwitchDevs
);
Paramètres
hdPhone
La poignée opaque du fournisseur de services pour le téléphone dont le mode de connexion doit être récupéré.
lpdwHookSwitchDevs
Pointeur vers un emplacement de taille DWORD dans lequel le fournisseur de services écrit le mode des périphériques de connexion du téléphone. Ce paramètre utilise l’une des constantes PHONEHOOKSWITCHDEV_. Si une position de bit est FALSE, le périphérique de commutateur de crochet correspondant est onhook. Si la valeur est TRUE, la partie microphone et/ou haut-parleur du périphérique de commutateur de connexion correspondant est offhook. Pour savoir si le microphone et/ou le haut-parleur sont activés, TAPI peut utiliser TSPI_phoneGetStatus.
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
Une fois que l’état de hookswitch d’un appareil change et que la surveillance du commutateur de connexion est activée, un message PHONE_STATE est envoyé à TAPI.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |