Partager via


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

Voir aussi

PHONE_REPLY

PHONE_STATE

Fonctions de service téléphonique supplémentaires

Vue d’ensemble de la référence TAPI 2.2