fonction phoneGetHookSwitch (tapi.h)

Article
03/02/2024

La fonction phoneGetHookSwitch retourne le mode hookswitch actuel de l’appareil téléphonique ouvert spécifié.

Syntaxe

LONG phoneGetHookSwitch(
  HPHONE  hPhone,
  LPDWORD lpdwHookSwitchDevs
);

Paramètres

hPhone

Gérez l’appareil téléphonique ouvert.

lpdwHookSwitchDevs

Pointeur vers un DWORD à remplir avec le mode des périphériques hookswitch du téléphone. Si la position du bit est FALSE, le périphérique de commutateur de connexion correspondant est onhook ; si la valeur EST TRUE, la partie microphone et/ou haut-parleur du périphérique hookswitch correspondant est offhook. Pour savoir si le microphone et/ou le haut-parleur sont activés, l’application peut utiliser phoneGetStatus. Ce paramètre utilise une ou plusieurs constantes PHONEHOOKSWITCHDEV_.

Valeur retournée

Retourne zéro si la requête réussit ou un numéro d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED.

Remarques

Une fois que l’état de hookswitch d’un appareil a changé et que la surveillance de hookswitch est activée, un message PHONE_STATE est envoyé à l’application .