fonction TSPI_phoneSetHookSwitch (tspi.h)

Article
03/03/2024

La fonction TSPI_phoneSetHookSwitch définit l’état de hook des périphériques de commutateur de connexion du téléphone ouvert spécifiés sur le mode spécifié. Seul l’état de hookswitch des périphériques hookswitch répertoriés est affecté.

Syntaxe

LONG TSPIAPI TSPI_phoneSetHookSwitch(
  DRV_REQUESTID dwRequestID,
  HDRVPHONE     hdPhone,
  DWORD         dwHookSwitchDevs,
  DWORD         dwHookSwitchMode
);

Paramètres

dwRequestID

Identificateur de la requête asynchrone.

hdPhone

Handle du téléphone contenant les périphériques hookswitch dont les modes doivent être définis.

dwHookSwitchDevs

Appareil(s) dont le mode de commutateur de connexion doit être défini. Ce paramètre utilise l’une des constantes PHONEHOOKSWITCHDEV_.

dwHookSwitchMode

Mode hookswitch à définir. Ce paramètre ne peut avoir qu’une des constantes PHONEHOOKSWITCHMODE_.

Valeur retournée

Retourne dwRequestID ou un numéro d’erreur si une erreur se produit. Le paramètre réel lResult du ASYNC_COMPLETION correspondant est égal à zéro si la fonction réussit ou s’il s’agit d’un numéro d’erreur si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALHOOKSWITCHMODE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONUNAVAIL.

Remarques

Le mode de commutateur de connexion est remplacé par le paramètre indiqué 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 autre ensemble de paramètres. Un message PHONE_STATE est envoyé à l’application une fois que l’état du commutateur de connexion a changé.