Partager via


phoneSetRing, fonction (tapi.h)

La fonction phoneSetRing sonne l’appareil téléphonique ouvert spécifié en utilisant le mode d’anneau et le volume spécifiés.

Syntaxe

LONG phoneSetRing(
  HPHONE hPhone,
  DWORD  dwRingMode,
  DWORD  dwVolume
);

Paramètres

hPhone

Gérez l’appareil téléphonique ouvert. L’application doit être propriétaire de l’appareil téléphonique.

dwRingMode

Modèle de sonnerie avec lequel sonner le téléphone. Ce paramètre doit être compris entre zéro et la valeur du membre dwNumRingModes dans la structure PHONECAPS . Si dwNumRingModes est égal à zéro, le mode de sonnerie du téléphone ne peut pas être contrôlé ; si dwNumRingModes a la valeur 1, la valeur 0 pour dwRingMode indique que le téléphone ne doit pas être exécuté (silence), et d’autres valeurs comprises entre 1 et dwNumRingModes sont des modes de sonnerie valides pour l’appareil téléphonique.

dwVolume

Niveau de volume avec lequel le téléphone sonne. Il s’agit d’un nombre compris dans la plage 0x00000000 (silence) à 0x0000FFFF (volume maximal). La granularité et la quantisation réelles des paramètres de volume dans cette plage sont spécifiques au fournisseur de services. Une valeur de dwVolume hors plage est définie sur la valeur la plus proche de la plage.

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_NOMEM, PHONEERR_NOTOWNER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALRINGMODE, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.

Remarques

Le fournisseur de services définit les modèles de sonnerie sonores réels correspondant à chacun des modes d’sonnerie du téléphone.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête tapi.h
Bibliothèque Tapi32.lib
DLL Tapi32.dll

Voir aussi

PHONECAPS

PHONE_REPLY

Fonctions de service téléphonique supplémentaires

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