fonction phoneSetHookSwitch (tapi.h)
La fonction phoneSetHookSwitch définit l’état de raccordement des périphériques hookswitch du téléphone ouvert spécifié sur le mode spécifié. Seul l’état de hookswitch des périphériques hookswitch répertoriés est affecté.
Syntaxe
LONG phoneSetHookSwitch(
HPHONE hPhone,
DWORD dwHookSwitchDevs,
DWORD dwHookSwitchMode
);
Paramètres
hPhone
Gérez l’appareil téléphonique ouvert. L’application doit être propriétaire du téléphone.
dwHookSwitchDevs
Appareil dont le mode hookswitch doit être défini. Ce paramètre utilise une seule des constantes PHONEHOOKSWITCHDEV_.
PHONEHOOKSWITCHDEV_HANDSET
Le combiné du téléphone.
PHONEHOOKSWITCHDEV_SPEAKER
Le haut-parleur ou l’assistant du téléphone.
PHONEHOOKSWITCHDEV_HEADSET
Le casque du téléphone.
dwHookSwitchMode
Mode hookswitch à définir. Ce paramètre utilise une seule des constantes PHONEHOOKSWITCHMODE_.
PHONEHOOKSWITCHMODE_ONHOOK
Le microphone et le haut-parleur de l’appareil sont tous deux onhook.
PHONEHOOKSWITCHMODE_MIC
Le microphone de l’appareil est actif, le haut-parleur est désactivé.
PHONEHOOKSWITCHMODE_SPEAKER
Le haut-parleur de l’appareil est actif, le microphone est désactivé.
PHONEHOOKSWITCHMODE_MICSPEAKER
Le microphone et le haut-parleur de l’appareil sont tous deux actifs.
Valeur retournée
Retourne un identificateur de requête positif si la fonction est terminée de manière asynchrone ou un nombre d’erreur négatif si une erreur se produit. Le paramètre dwParam2 du message PHONE_REPLY correspondant est égal à zéro si la fonction réussit ou s’il s’agit d’un numéro d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :
PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOTOWNER, PHONEERR_NOMEM, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALHOOKSWITCHMODE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONESTATE, PHONEERR_UNINITIALIZED.
Remarques
Le mode hookswitch est le même pour tous les appareils spécifiés. Si des paramètres différents sont souhaités, cette fonction peut être appelée plusieurs fois avec un ensemble de paramètres différent. Un message PHONE_STATE est envoyé à l’application une fois que l’état de hookswitch a changé.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tapi.h |
| Bibliothèque | Tapi32.lib |
| DLL | Tapi32.dll |